home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / spitfire.zip / SPITFIRE.DOC < prev    next >
Text File  |  1993-04-24  |  209KB  |  3,836 lines
  1.          
  2.         
  3.         
  4.         
  5.         
  6.         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.         
  14.         
  15.         
  16.         
  17.         
  18.         
  19.         
  20.         
  21.         
  22.       _________________________________________________________________________
  23.          ___________________                             ___________________
  24.             ________________       S P I T F I R E       ________________
  25.                _____________  -------------------------  _____________
  26.                   __________    Bulletin Board System    __________
  27.                      _______        for MS/PC DOS        _______
  28.                         ____      Personal Computers     ____
  29.                            _______________________________
  30.                              ____                    ____
  31.                                ____  Version 2.5   ____
  32.                                  ___________________
  33.  
  34.  
  35.  
  36.                         Copyright (C) 1987, 88 by Mike Woltz
  37.                      ------------------------------------------
  38.                                Buffalo Creek Software
  39.         
  40.         
  41.         
  42.                      ------------------------------------------
  43.                      >>> Release Date      October 22, 1988 <<<
  44.                      ------------------------------------------
  45.         
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                       TABLE OF CONTENTS
  59.                                     ---------------------
  60.         
  61.                #  Section Title                                     Page #
  62.               +--+------------------------------------------------+------+
  63.                   Introduction..................................... 1
  64.               [1] 1.0  Important Notice............................ 1
  65.                   1.1  Copyright & Registered Trademark Notice..... 2
  66.               [2] 2.0  Spitfire Hardware Requirements.............. 3
  67.                   2.1  Modems...................................... 4
  68.                   2.2  Numeric Result Codes........................ 4
  69.                   2.3  Modem Initialization........................ 4
  70.                   2.4  Getting Started............................. 5
  71.                   2.5  Spitfire File Paths......................... 11
  72.               [3] 3.0  Spitfire System Files....................... 12
  73.                   3.1  Spitfire Work Files......................... 13
  74.                   3.2  Spitfire Display Files...................... 14
  75.                   3.3  Spitfire Menu Files......................... 16
  76.                   3.4  Spitfire File Clarifications................ 19
  77.                   3.5  About Spitfire Display Files................ 22
  78.                   3.6  Backup Files................................ 22
  79.                   3.7  THOUGHTS.BBS................................ 23
  80.               [4] 4.0  Command Line Parameters..................... 23
  81.                   4.1  SF.BAT...................................... 24
  82.               [5] 5.0  Setting Up The System Records............... 24
  83.               [6] 6.0  Spitfire Questionnaires..................... 27
  84.               [7] 7.0  The Function Keys........................... 28
  85.                   7.1  Function Key Definitions.................... 28
  86.               [8] 8.0  The ALT Keys................................ 30
  87.                   8.1  Available Keys.............................. 30
  88.                   8.2  ALT Key Definitions......................... 31
  89.               [9] 9.0  Main Menu Explained......................... 32
  90.                   9.1  Main Menu Example........................... 33
  91.                   9.2  Explanation of Main Menu Features........... 33
  92.              [10] 10.0 Message Menu Explained...................... 36
  93.                   10.1 Message Menu Example........................ 36
  94.                   10.2 Message Menu Explanation.................... 36
  95.              [11] 11.0 File Menu Example........................... 39
  96.                   11.1 File Menu Explanation....................... 39
  97.                   11.2 Upload/Download Protocols................... 42
  98.              [12] 12.0 Sysop Menu Explained........................ 42
  99.                   12.1 Sysop Menu Explanation...................... 43
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                                       TABLE OF CONTENTS (cont)
  113.                                     ---------------------
  114.         
  115.                #  Section Title                                     Page #
  116.               +--+------------------------------------------------+------+
  117.              [13] 13.0 Special Commands For Sysop Status........... 47
  118.              [14] 14.0 Hardware/Software Data Flow Control......... 48
  119.              [15] 15.0 Screen Save Feature......................... 48
  120.              [16] 16.0 SPITFIRE Doors Feature...................... 48
  121.                   16.1 SPITFIRE Doors Display Files................ 50
  122.                   16.2 SPITFIRE Doors Support...................... 51
  123.              [17] 17.0 External File Transfer Protocols............ 51
  124.                   17.1 External Download Protocols................. 51
  125.                   17.2 External Upload Protocols................... 54
  126.                   17.3 External Protocol Support................... 57
  127.              [18] 18.0 Spitfire Technical Reference Information.... 57
  128.              [19] 19.0 Comment From The Author..................... 61
  129.              [20] 20.0 SPITFIRE Utilities.......................... 62
  130.             Appendix A Modem Initialization Strings................ 65         
  131.             Appendix B Registered SPITFIRE Boards.................. 66 
  132.             Appendix C SPITFIRE Questions and Answers.............. 67
  133.  
  134.                                                                          Page 1
  135.         -----------------------------------------------------------------------
  136.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  137.         -----------------------------------------------------------------------
  138.  
  139.         
  140.         INTRODUCTION
  141.         ------------
  142.         
  143.              SPITFIRE is a bulletin board program written in Borland's Turbo
  144.         Pascal (Version 5.0).  Designed on an IBM Personal Computer, SPITFIRE
  145.         is compatible with MS/PC DOS machines (IBM "Compatibles").
  146.         
  147.              SPITFIRE is distributed under the "Shareware" concept.  You are
  148.         encouraged to distribute this software to others, in its original,
  149.         unmodified condition, as long as you DO NOT charge for this program
  150.         in any way, shape or form.
  151.         
  152.         
  153.         1.0 - IMPORTANT NOTICE!
  154.         -----------------------
  155.         
  156.              Thank you for taking the time and expense to obtain SPITFIRE.
  157.         Surely, after you've had a chance to look SPITFIRE over, you'll agree
  158.         it is a powerful bulletin board program which combines both speed,
  159.         flexibility and user ease.
  160.         
  161.              This program, like many others, is distributed under the
  162.         "Shareware" concept.  Since that SPITFIRE is not a program which
  163.         appeals to a mass market, your support is vital. SPITFIRE can be 
  164.         utilized on a trial basis for not more than thirty (30) days or 500 
  165.         callers, whichever comes first.  In the event this software is used 
  166.         beyond the trial period, then a registration fee of $65.00 is required.
  167.         
  168.              Your registration of SPITFIRE will provide you with full support
  169.         and notification of future updates and revisions of SPITFIRE.  Such
  170.         support and notification may be terminated at any time without notice.
  171.         
  172.              Many of you will be running SPITFIRE 24 hours per day, 7 days per
  173.         week.  This is more than any other program you'll use.  Considering
  174.         that, it becomes apparent that the registration fee is truly minimal.
  175.          ____________________________________________________________________
  176.         |                                                                    |
  177.         | Registration is simple & easy.  Send a $65.00 registration fee to: |
  178.         |____________________________________________________________________|
  179.                          |  _____________________________  |
  180.                          | |                             | |
  181.                          | |    Buffalo Creek Software   | |
  182.                          | |      Attn:  Mike Woltz      | |
  183.                          | |      913 - 39th Street      | |
  184.                          | | West Des Moines, Iowa 50265 | |
  185.                          | |_____________________________| |
  186.                          |_________________________________|
  187.         
  188.  
  189.                                                                          Page 2
  190.         -----------------------------------------------------------------------
  191.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  192.         -----------------------------------------------------------------------
  193.         
  194.         
  195.             Mike Woltz and Buffalo Creek Software shall not be held responsible
  196.         for any damage incurred by the user to hardware, software, or
  197.         peripheral devices while running SPITFIRE.  All responsibility lies
  198.         with the user of the software.
  199.         
  200.             No part of this manual may be reproduced, transmitted, transcribed,
  201.         stored in a retrieval system, or translated into any language (natural
  202.         or computer), in any form or by any means,  without the prior 
  203.         written permission of Mike Woltz.
  204.         
  205.             THIS SOFTWARE IS NOT FOR SALE!  You are granted a limited license
  206.         to use the software described in this manual. The software may be used
  207.         or copied only in accordance with the terms set forth herein.
  208.         
  209.             You may not make any changes or modifications to SPITFIRE, and you
  210.         may not de-compile, disassemble, or otherwise reverse-engineer it. You 
  211.         may not rent or lease it to others.
  212.         
  213.             No fee, charge or other compensation may be accepted or requested 
  214.         by anyone without express written permission from Mike Woltz.  This 
  215.         includes disk vendors.
  216.         
  217.             Operators of electronic bulletin board systems (Sysops) may post 
  218.         SPITFIRE for downloading by their users without written permission 
  219.         only as long as the conditions set forth herein are met.  A fee may be 
  220.         charged for access to the BBS as long as no specific fee is charged 
  221.         for access to the SPITFIRE files.
  222.         
  223.             Distributors of public domain and user supported software, such 
  224.         as disk vending services, may distribute copies of SPITFIRE subject to 
  225.         the above conditions only after obtaining written permission from Mike 
  226.         Woltz.
  227.         
  228.         
  229.         1.1 - COPYRIGHT & REGISTERED TRADEMARK NOTICE
  230.         ---------------------------------------------
  231.         
  232.              SPITFIRE and affiliate programs distributed with it are not to be
  233.         modified or distributed in modified form without the express written
  234.         consent of Mike Woltz.
  235.         
  236.              SPITFIRE is NOT to be sold, used or modified for, or with, illegal
  237.         intent under the penalty of law.
  238.         
  239.         `SPITFIRE' is Copyright (C) 1987, 88 by Mike Woltz
  240.  
  241.         `SPITFIRE' is a registered trademark of Buffalo Creek Software.
  242.  
  243.                                                                          Page 3
  244.         -----------------------------------------------------------------------
  245.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  246.         -----------------------------------------------------------------------
  247.         
  248.         
  249.         `Turbo Pascal' is a registered trademark of Borland International Corp.
  250.         
  251.         `BRK' is Copyright (C) 1985, by Solid Systems
  252.         
  253.         `SEALINK'  is (C) Copyright 1986 by System Enhancement Associates
  254.         
  255.         `WILDFIRE' is Copyright (C) 1988 by Stephen L. Cox
  256.         
  257.         `DSZ' is Copyright (C) 1988 by Omen Technology INC
  258.  
  259.  
  260.         2.0 - SPITFIRE HARDWARE REQUIREMENTS
  261.         ------------------------------------
  262.         
  263.              The following are considered the minimum equipment requirements
  264.         for running SPITFIRE:
  265.         
  266.                    [1]  At least 320K Memory
  267.                    [2]  Fixed Disk (preferable) - Two disk drives will work
  268.                    [3]  Modem (US Robotics or Hayes preferable)
  269.                    [4]  Monitor
  270.         
  271.              SPITFIRE requires several files being open at the same time.
  272.         For this reason, you will need to have the following files and buffers
  273.         set in your system's CONFIG.SYS file located in your root directory.
  274.         SPITFIRE may not work properly if this is not done!
  275.         
  276.              CONFIG.SYS should have the following settings:
  277.         
  278.                              FILES=25
  279.                              BUFFERS=30
  280.                              DEVICE=ANSI.SYS
  281.                              DEVICE=BRK.DRV
  282.         
  283.              The "DEVICE=BRK.DRV" is optional, however, if your system supports
  284.         the use of SPITFIRE Doors or External File Transfer Protocols, then the
  285.         use of BRK (or some similar utility) is certainly recommended.  More
  286.         information regarding the use of BRK is provided in the External File
  287.         Protocols Section of this manual.
  288.  
  289.              If you are unfamiliar with how CONFIG.SYS works, consult your DOS
  290.         manual. 
  291.         
  292.              SPITFIRE includes an option which allows the Sysop to shell to
  293.         DOS from within the program.  For this to work properly, you MUST have
  294.         a copy of COMMAND.COM in the root directory of the drive in which
  295.         SPITFIRE.EXE resides.
  296.  
  297.                                                                          Page 4
  298.         -----------------------------------------------------------------------
  299.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  300.         -----------------------------------------------------------------------
  301.         
  302.         
  303.         2.1 - MODEMS
  304.         ------------
  305.          
  306.              SPITFIRE automatically determines your incoming callers' baud
  307.         rates.  In order for this to work, your modem must be able to send
  308.         numeric result codes.  Appendix A contains a list of modems and their
  309.         corresponding initialization strings which have been tested to work
  310.         with SPITFIRE.
  311.         
  312.  
  313.         2.2 - NUMERIC RESULT CODES
  314.         --------------------------
  315.         
  316.              SPITFIRE determines the baud rate of incoming calls by receiving
  317.         the numeric result code from your modem when the modem establishes
  318.         carrier detect.  Check your (Modem) owner's manual for these numeric
  319.         codes.        
  320.         
  321.              Note that these codes can be changed within SPITFIRE by selecting
  322.         ALT+M while SPITFIRE is waiting for a caller.  SPITFIRE defaults to the
  323.         codes listed below:
  324.         
  325.                                    300  Baud #  1
  326.                                    1200 Baud #  5
  327.                                    2400 Baud # 10
  328.                                    9600 Baud # 17
  329.         
  330.                                 Error-checking modems
  331.                                 -----------------------
  332.                                    1200 Baud # 15
  333.                                    2400 Baud # 16
  334.                                    9600 Baud # 17
  335.         
  336.         The SPITFIRE default modem initialization string seems to work with
  337.         most modems.  The Hayes 2400 (and possibly other Hayes Smartmodems)
  338.         requires a unique initialization string that will be found in Appendix
  339.         A of this manual.
  340.         
  341.         
  342.         2.3 - MODEM INITIALIZATION
  343.         --------------------------
  344.         
  345.              SPITFIRE automatically sends an "ATZ", pauses 1.5 seconds and then
  346.         sends the configured modem initialization string to the modem after
  347.         each call.  This procedure seems to work fine for most modems.  If you
  348.         are using a Hayes 2400 Smartmodem or a Everex internal 2400 or are 
  349.         having difficulties, it is suggested you try the string listed below:
  350.         
  351.                               AT&C1&D2&T5M0H0X1V0E0S2=1S0=0
  352.  
  353.  
  354.                                                                          Page 5
  355.         -----------------------------------------------------------------------
  356.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  357.         -----------------------------------------------------------------------
  358.         
  359.         
  360.         
  361.                 
  362.              SPITFIRE'S default initialization string (listed below) seems to 
  363.         work fine with most modems:
  364.         
  365.                                ATS0=1Q0V0E0M0H0S2=1X1
  366.         
  367.              In the event you are using an USR HST and wish to run your BBS
  368.         at 19200 baud, then the below listed initialization string works:
  369.  
  370.                         ATS0=1&B1&N0&H3&R2&Y3Q0V0E0M0H0S2=1X1
  371.         
  372.              Should you need to change the modem initialization string, you
  373.         select ALT+M at the "SPITFIRE ready for caller" prompt.  Appendix A
  374.         contains a complete listing of modems which have been tested with
  375.         SPITFIRE and their known corresponding initialization strings.  The
  376.         modem initialization string can also be altered at the DOS prompt by
  377.         entering the following command line parameters:
  378.         
  379.           SPITFIRE /M  ATS0=1Q0V0E0M0H0S2=1X1 (Your Initialization String)
  380.  
  381.               Using the same command line parameters, the modem initialization
  382.         string can be included within the SF.BAT file.  Please note, however,
  383.         the command line parameters set in SF.BAT will always override those
  384.         set by using ALT+M at the "SPITFIRE ready for caller" prompt.
  385.  
  386.  
  387.  
  388.         2.4  GETTING STARTED
  389.         --------------------
  390.         
  391.              If you're like most, you're probably not too thrilled with the
  392.         prospect of reading a gargantuan document such as this.  Most folks are
  393.         going to boot this program and try to run SPITFIRE without reading
  394.         further, so here are some quick guidelines regarding your initial setup
  395.         of SPITFIRE.
  396.         
  397.              [1]  Create a directory named SF on the drive on which you intend
  398.                   to run SPITFIRE.  Copy all SYSTEM FILES into your newly
  399.                   created SF directory.  (Listed in Section 3.0)
  400.         
  401.              [2]  You should have received a file named SF.BAT with your
  402.                   SPITFIRE package.  You may need to use your favorite text
  403.                   editor (as long as it saves in ASCII format) to modify
  404.                   this file.  Examine the default values (such as target &
  405.                   source drives) and configure them to suit your needs.
  406.  
  407.                                                                          Page 6
  408.         -----------------------------------------------------------------------
  409.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  410.         -----------------------------------------------------------------------
  411.  
  412.  
  413.  
  414.                   (Example: Default on drive specification is C: and if
  415.                   you're running SPITFIRE on drive D, then you'll have to
  416.                   change it to D:).  After finishing that, look for the line
  417.                   that contains SPITFIRE /I2400 /C1.  "/I2400" indicates the
  418.                   top speed of your modem. You may have to change this to the
  419.                   highest speed your modem is capable of. (Example:  If you
  420.                   have a 9600 baud modem, change the string to read
  421.                   "SPITFIRE /I9600 /C1" or "SPITFIRE /I19200 /C1").  "/C1"
  422.                   indicates the COM port you are using.  If you are using
  423.                   COM port 2, you need to change the string to read
  424.                   "SPITFIRE /I2400 /C2".  After you've made your changes,
  425.                   be certain to save your modified file to disk.
  426.         
  427.              [3]  Now you are ready to boot SPITFIRE by using your SF.BAT 
  428.                   file.  When first booting SPITFIRE, you will get the prompt
  429.                   "SFSYSDAT.SYS not found!  Do you wish to create it? [y/n]".
  430.                   Answer "Y" and SPITFIRE will create one.  Next you will get
  431.                   the prompt "SFUSERS.DAT not found!  Do you wish to create 
  432.                   it? [y/n]".  Answer "Y" and SPITFIRE will create one. Then 
  433.                   you will get the prompt "SFSYSINF.SYS not found! Do you 
  434.                   wish to create it? [y/n]".  Answer "Y" and SPITFIRE will 
  435.                   create one.  The first thing we have to be concerned with
  436.                   is the dilemma of not having properly assigned the correct 
  437.                   COM port.  In this event you will get a message that states 
  438.                   "Comm Port Number ?  is not responding!  Spitfire halting."
  439.                   If that happens, refer to step number 2 in this Section.  If
  440.                   all goes well, shortly after that, you will be prompted for
  441.                   the Sysop Name.  The name you enter here is the name that
  442.                   users will see credited as Sysop of the system.  In all 
  443.                   probability, you will wish to enter your real full name.
  444.                   After that, SPITFIRE will ask you for a Sysop User Name.
  445.                   It is recommended you answer this prompt with "Sysop".  All 
  446.                   comments left by your users will be left to this name you 
  447.                   have chosen.  At this time SPITFIRE will prompt you to input
  448.                   password, phone number, city and state and  birthdate.
  449.                   SPITFIRE uses the responses you enter here to automatically
  450.                   add you as the first user in the SFUSERS.DAT file.
  451.                   
  452.                   If your modem is malfunctioning, is turned off or not 
  453.                   connected, SPITFIRE will then relay the message "Your modem
  454.                   is not responding properly!  Do you wish to continue? [y/n]".
  455.                   Answer "Y" and SPITFIRE will prompt "SPITFIRE ready for
  456.                   caller at [CURRENT TIME]".  Hit ALT+M to change the modem
  457.                   initialization string that is proper for your modem.
  458.  
  459.                                                                          Page 7
  460.         -----------------------------------------------------------------------
  461.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  462.         -----------------------------------------------------------------------
  463.  
  464.  
  465.       
  466.       
  467.              [4]  At the "SPITFIRE ready for caller..." prompt, press ALT+S to
  468.                   log on locally as Sysop.  When asked for your name, you must
  469.                   enter the same name as you entered as the Sysop User Name at
  470.                   the beginning of the boot.  (If you use the name "Sysop", the
  471.                   system will ask for a last name.  Here you can simply hit
  472.                   <RETURN> and continue.) Then enter the password you have
  473.                   selected previously.  When you get to the Main Menu, press
  474.                   F2 and set your security level to 999.  Then log off in a
  475.                   normal fashion.
  476.         
  477.              [5]  At the "SPITFIRE ready for caller" prompt, press ALT+Z.  
  478.                   Pressing ALT+Z opens the window which allows you to
  479.                   configure SPITFIRE.  The commands that you will see 
  480.                   are listed as such below: 
  481.                                
  482.                  --[ SPITFIRE CONFIGURATION ]--
  483.                  <1>  Sysop User Name...............: Sysop
  484.                  <2>  Sysop Security................: 50
  485.                  <3>  New User Security.............: 10
  486.                  <4>  New User Log On Time..........: 45
  487.                  <5>  300 Baud Users................: Not Allowed
  488.                  <6>  Daily Time Limit..............: 60
  489.                  <7>  Log On Time Limit.............: 60
  490.                  <8>  Type of BBS...................: Public BBS
  491.                  <9>  Maximum Users.................: 500
  492.                  <10> Maximum User Calls Per Day....: 10             
  493.                  <11> Number Of Callers.............: 1
  494.                  <12> Graphics......................: Ansi Available
  495.                  <13> Second Password...............: Second Password Required
  496.                  <14> Page..........................: On
  497.                  <15> Upload/Download Ratio Prompt..: 10
  498.                  <16> Upload Time Compensation......: 1.000
  499.                  <17> Drop to DOS Password..........: Spitfire
  500.                  <18> BBS Starting Date.............: October 22, 1988
  501.  
  502.                  
  503.                         ENTER COMMAND [<Q>...  Quit]:             
  504.              
  505.  
  506.              Command <1> Allows you to change the Sysop User Name.
  507.         
  508.              Command <2> Allows you to change the Sysop security level.  Any
  509.                          user with an access equal to or greater than this
  510.                          numeric value can read all messages (public and
  511.                          private), move messages, undelete messages, delete
  512.                          any message and overwrite existing files during
  513.                          uploading (if the filename already exists).
  514.  
  515.                                                                          Page 8
  516.         -----------------------------------------------------------------------
  517.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  518.         -----------------------------------------------------------------------
  519.  
  520.  
  521.         
  522.              Command <3> Allows you to set the default security level for a new
  523.                          user.
  524.         
  525.              Command <4> Allows you to set the amount of time on the board for
  526.                          the new user's visit.  (First day only)
  527.         
  528.              Command <5> Toggles whether you are going to allow 300 baud users.
  529.                          The system will display the file NO300.BBS to the
  530.                          screen and log a 300 baud caller off if you do not
  531.                          allow 300 baud callers.
  532.         
  533.              Command <6> Sets the amount of time per day a user is allowed on
  534.                          the board.  See Section 3.4 for more information on
  535.                          setting time limits.
  536.         
  537.              Command <7> Sets the amount of time per call, per user.  See
  538.                          Section 3.4 for more information.
  539.  
  540.              Command <8> Toggles whether you are going to have a PRIVATE or a
  541.                          PUBLIC BBS.  If you toggle this as a Private BBS, then
  542.                          the user attempting to log on must be in the users
  543.                          file to be granted access.  If you have the system
  544.                          toggled as a Private BBS and a caller tries to log on
  545.                          as new user, the system will display PRIVATE.BBS and
  546.                          log the caller off.
  547.  
  548.              Command <9> Determines the amount of users you will allow to
  549.                          utilize your BBS.  (i.e. -  If you have this value set
  550.                          at 500 and you already have 500 users and a new user
  551.                          (501) tries to log on, the system displays the file
  552.                          MAXUSERS.BBS and logs the user off.)
  553.         
  554.             Command <10> This sets the limit of how many times a user can call
  555.                          your board per day.  If this amount is exceeded, the
  556.                          system will display TOOMANY.BBS and log the user off.
  557.         
  558.             Command <11> This gives you the opportunity to set the number of
  559.                          callers.  The reason for this is if you are already 
  560.                          running an established board, you can enter the
  561.                          the current number of callers, so as not to start 
  562.                          the BBS with Caller Number 1.
  563.                                  
  564.             Command <12> Toggles whether or not you wish to offer Ansi
  565.                          graphics.  If you wish to offer Ansi graphics, you 
  566.                          must create .CLR files to match the display .BBS 
  567.                          files you have: (i.e. -  ALL.BBS {non-Ansi} & ALL.CLR
  568.  
  569.                                                                          Page 9
  570.         -----------------------------------------------------------------------
  571.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  572.         -----------------------------------------------------------------------
  573.         
  574.         
  575.                          {Ansi Graphics}).  In order for you to see the Ansi 
  576.                          Graphics locally, you must have DEVICE=ANSI.SYS in
  577.                          your CONFIG.SYS file. 
  578.         
  579.             Command <13> Toggles password prompt.  If turned on, then after
  580.                          entering the first password, the system prompts the
  581.                          users for their birth date.  Should the users not know
  582.                          their birth date, the system will log them off.
  583.         
  584.             Command <14> Toggles the Page on and off.  If the Page is on and
  585.                          you are paged a Prompt Bell is sounded to alert you
  586.                          to the page.  If the Page is toggled off and a user 
  587.                          pages you, you don't receive the page and the system 
  588.                          displays SFPAGED.BBS/CLR to the screen, which normally
  589.                          is written to notify the user that you are not 
  590.                          available to chat.
  591.        
  592.             Command <15> Sets the ratio of downloads to uploads.  (i.e. - If a
  593.                          user uploads 1 file and downloads x amount of files
  594.                          that exceeds the "x" amount, then after the download 
  595.                          is completed, SPITFIRE sends SFRATIO.BBS unless 
  596.                          DAILYLMT.DAT instructs SPITFIRE not to).  SFRATIO.BBS
  597.                          is normally written to notify the users that their
  598.                          upload/download ratio is unacceptable.
  599.                         
  600.             Command <16> This sets the time compensation for time used during
  601.                          an upload.  The default is 1.000.  Should you wish to
  602.                          have the user rewarded with extra time for an upload,
  603.                          you can increase this numeric value.
  604.        
  605.             Command <17> Sets the password that is needed to drop to DOS from a
  606.                          remote location.  The default is "Spitfire", but you
  607.                          will wish to change this for the sake of security.
  608.        
  609.             Command <18> This provides an opportunity to set the starting date
  610.                          of your bulletin board.  The reason for this is if you
  611.                          are already running an established board, you can 
  612.                          enter the original starting date of your BBS 
  613.                          rather than the date of your conversion to SPITFIRE.
  614.                         
  615.                   After setting your configuration for SPITFIRE enter <Q> 
  616.                   to Quit and you are returned to the "Ready..." prompt.  
  617.              
  618.              [6]  You must now set the file paths you wish to use to run 
  619.                   SPITFIRE.  This is done by pressing ALT+P at the 
  620.                   "Ready..." prompt.  Pressing ALT+P opens the window which 
  621.                   allows you to set the file paths which will be used in
  622.                   running SPITFIRE.  The commands that you will see are
  623.                   listed as such below: 
  624.  
  625.                                                                         Page 10
  626.         -----------------------------------------------------------------------
  627.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  628.         -----------------------------------------------------------------------
  629.         
  630.  
  631.         
  632.              --[SPITFIRE FILE PATHS]--
  633.              
  634.              <1>  External Transfer Protocols......: Yes
  635.              <2>  Work Files Path..................: C:\SF\WORK
  636.              <3>  Display Files Path...............: C:\SF\DISPLAY
  637.              <4>  External Transfer Path...........: C:\SF\EXTERNAL
  638.              
  639.                          ENTER COMMAND [ <Q>...Quit] :
  640.                          
  641.              Command <1> Toggles whether you wish to implement the use of
  642.                          the external transfer protocol feature.
  643.                          
  644.              Command <2> Allows you to specify the directory in which the
  645.                          SPITFIRE Work Files reside.  (For more information
  646.                          on this refer to Section 2.5 - File Paths.)  All
  647.                          files which belong in the Work File Path are 
  648.                          specified as such with a (WORK) in the file
  649.                          description in Section 3.1 - SPITFIRE work files.
  650.                          
  651.              Command <3> Allows you to specify the directory in which the
  652.                          SPITFIRE Display Files reside.  All files with a
  653.                          BBS or CLR extension are Display Files and should
  654.                          reside in the directory you designate here.  (For
  655.                          more information refer to Secion 2.5 - File Paths.)
  656.                          All files which belong in the Display File Path are
  657.                          specified as such with a (DISPLAY) in the file
  658.                          description in Section 3.2 - SPITFIRE display files.
  659.                          
  660.              Command <4> Allows you to specify the directory from which you
  661.                          opt to run the SPITFIRE External Transfer Protocols.
  662.                          All files which you are using to run the External
  663.                          Transfer Protocols must reside in the directory you
  664.                          designate here. (For more information on the External
  665.                          Transfer Protocols refer to Section 17.0 - External
  666.                          File Transfer Protocols.)
  667.                          
  668.              Establishing specified file paths will provide the Sysop with more
  669.              manageable directories.  However, if the Sysop prefers, all files
  670.              can be accessed from the SF directory.  Simply enter C:\SF 
  671.              in response to each of the above files path questions. 
  672.  
  673.                        
  674.              After you've configured SPITFIRE to meet your specifications, 
  675.              Quit and return to the "SPITFIRE ready for caller..." prompt.
  676.         
  677.              At the "SPITFIRE ready for caller..." prompt, hit ALT+R to
  678.         configure your system records.  For more information on this feature,
  679.         refer to Section 5.0 of this manual.
  680.  
  681.                                                                         Page 11
  682.         -----------------------------------------------------------------------
  683.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  684.         -----------------------------------------------------------------------
  685.  
  686.  
  687.         
  688.              After you've completed that, you're ready to go!
  689.         
  690.              If you're having problems running SPITFIRE, and you're sure you've
  691.         tried everything, gather together a report of your version number and
  692.         all the information pertaining to the difficulties (such as System,
  693.         Modem, Comm Port) you are experiencing and contact Buffalo Creek's BBS
  694.         (515-225-8496) for registered support.  Be as thorough as possible so
  695.         an accurate determination of the cause of your problem(s) can be made.
  696.         Every effort will be made to determine and correct the problem!
  697.                 
  698.              Further, if you had a problem that isn't covered by this manual
  699.         and were able to work it out without registered support, please contact
  700.         Buffalo Creek's BBS so the information you have discovered can be
  701.         shared with other users of SPITFIRE.  Also, please report any unique
  702.         configurations you may discover so everyone will benefit from your
  703.         ideas.
  704.  
  705.  
  706.  
  707.         2.5 SPITFIRE FILE PATHS
  708.         -----------------------
  709.         
  710.             SPITFIRE supports file paths for the files which are accessed in
  711.         the process of its execution.  The Sysop has the option of placing all
  712.         SPITFIRE files into the SF directory (SYSTEM) or, if preferred, setting
  713.         up separate directories for the WORK, DISPLAY and EXTERNAL files.
  714.         Designating individual file paths for your WORK, DISPLAY and EXTERNAL
  715.         files can help make your directories more manageable.
  716.         
  717.              The SYSTEM files path contains files which are required for the 
  718.         execution of SPITFIRE.  The WORK files path contains files which
  719.         SPITFIRE accesses and writes to periodically in the process of the
  720.         program execution.  The DISPLAY files path contains all files which
  721.         are displayed to user while logged on the BBS.  The EXTERNAL files path
  722.         includes files necessary to provide the user with optional
  723.         transfer protocols other than those automatically accessed from
  724.         within SPITFIRE.
  725.         
  726.         **NOTE** All DISPLAY files are optional.  Should the Sysop choose
  727.         not to use these available files, SPITFIRE will operate perfectly
  728.         fine.  In fact, SPITFIRE will display a default message in a number
  729.         of incidences if the optional display file is not found.  The DISPLAY
  730.         files merely provide an additional means by which the Sysop can create
  731.         unique screens to personalize their BBS system.
  732.  
  733.                                                                        Page 12
  734.         -----------------------------------------------------------------------
  735.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  736.         -----------------------------------------------------------------------
  737.         
  738.         
  739.  
  740.              The system files MUST reside in the SF directory that was created
  741.         when setting up SPITFIRE.  The WORK, DISPLAY and EXTERNAL file paths
  742.         are set by pressing ALT-P at the "SPITFIRE Ready For Caller" prompt.
  743.         (Refer to Section 2.4)
  744.         
  745.              The following sections, 3.0 through 4.0, discuss individually
  746.         files used by SPITFIRE.  After the file description, a (SYSTEM),
  747.         (WORK) or (DISPLAY) is included to help you in determine in which
  748.         directory the file should be placed.  No files which will be used
  749.         in your External Protocol Path will be found.  These are not included
  750.         in the SPITFIRE package because they are separate programs written
  751.         by other programmers.  
  752.     
  753.   
  754.         3.0 - SPITFIRE SYSTEM FILES
  755.         ---------------------------
  756.         
  757.              There are four file types that comprise SPITFIRE and allow it
  758.         to function: System, Work, Display and External Protocol.
  759.         
  760.              The first type is referred to as SYSTEM FILES.  System Files
  761.         are mandatory for SPITFIRE's operation and MUST reside in your main
  762.         SPITFIRE directory from which you run SPITFIRE.  These files are 
  763.         accessed frequently by SPITFIRE during program operation.
  764.        
  765.  
  766.              SPITFIRE.EXE  - Main System Program            (SYSTEM)
  767.              SFMAIN  .MNU  - Spitfire Main Menu             (SYSTEM) 
  768.              SFMSG   .MNU  - Spitfire Message Menu          (SYSTEM) 
  769.              SFFILE  .MNU  - Spitfire File Menu             (SYSTEM)  
  770.              SFSYSOP .MNU  - Spitfire Sysop Menu            (SYSTEM)
  771.  
  772.               
  773.              The above-mentioned files MUST be present for SPITFIRE to 
  774.         run. SPITFIRE will halt if these files are not found in the directory 
  775.         in which you are running your system.
  776.         
  777.              The following system files will be created by SPITFIRE if they
  778.         are not already present.
  779.         
  780.              SFSYSDAT.SYS  - Starting date, number of callers, etc   (SYSTEM)
  781.              SFSYSINF.SYS  - File paths, descriptions, etc           (SYSTEM) 
  782.              SFEVENTS.DAT  - Contains scheduled events information   (SYSTEM)
  783.  
  784.                                                                        Page 13
  785.         -----------------------------------------------------------------------
  786.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  787.         -----------------------------------------------------------------------
  788.         
  789.         
  790.  
  791.              Other system files which will need to reside in the main 
  792.         SPITFIRE directory include:
  793.  
  794.              SFREMOTE.BAT  - Used for remote Drop to DOS             (SYSTEM)
  795.              SF      .BAT  - Invokes SPITFIRE                        (SYSTEM) 
  796.              SFDOOR  .MNU  - Spitfire Door Menu                      (SYSTEM)
  797.              JOKER   .DAT  - List of undesirable caller names        (SYSTEM)
  798.              DAILYLMT.DAT  - Determines daily time limits, number of
  799.                              downloadable files and bytes for each security
  800.                              level.                                  (SYSTEM)
  801.              SPITFIRE.HLP  - Help with all commands at all menus.  This file
  802.                              can be modified via SFHELP.EXE.  Consult the
  803.                              document accompanying SFHELP.EXE.       (SYSTEM)
  804.              SFPROTCO.HLP  - Extra help with Uploads/Downloads.  This is a
  805.                              simple textfile that you can modify with your
  806.                              favorite text editor, provided it saves in
  807.                              ASCII format.                           (SYSTEM)
  808.              
  809.              The SFREMOTE.BAT, SFPROTCO.HLP, SFDOOR.MNU, SF.BAT, DAILYLMT.DAT,
  810.         SPITFIRE.HLP and JOKER.DAT may be edited to your own personal tastes.
  811.         
  812.         
  813.        3.1  SPITFIRE WORK FILES
  814.        ------------------------
  815.  
  816.              The second type of file category is WORK FILES.  Although not all
  817.         of these files are required to run SPITFIRE, you will find them
  818.         invaluable in the operation of your BBS system.  These files are
  819.         accessed routinely and are periodically written to during the course
  820.         of SPITFIRE's execution.  In the event the required work files are
  821.         not found, SPITFIRE will create them.
  822.    
  823.            SFUSERS .DAT  - User data file                          (WORK)
  824.            SFUSERS .PTR  - User data pointer file                  (WORK)
  825.            SFMSG   .DAT  - All messages are contained here         (WORK)
  826.            SFMSG   .PTR  - Message pointers for scans, etc         (WORK)   
  827.            CALLERS .LOG  - Record of the users' activities         (WORK)
  828.            HEYSYSOP.LOG  - Record of special sysop notification    (WORK)    
  829.            SFNEWU  .QUE  - New user questionnaire                  (WORK)
  830.            SFNEWU  .ANS  - Contains new user questionnaire answers (WORK)
  831.            SFMAIN  .QUE  - Questionnaire at Main Menu for users    (WORK)
  832.            SFMAIN  .ANS  - Answers to Main Menu Questionnaire      (WORK)
  833.            SFBBSLST.DAT  - Contains list of other boards to call   (WORK)
  834.  
  835.                                                                        Page 14
  836.         -----------------------------------------------------------------------
  837.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  838.         -----------------------------------------------------------------------
  839.         
  840.         
  841.  
  842.         3.2 SPITFIRE DISPLAY FILES
  843.         --------------------------
  844.         
  845.              The following files are used as display files by SPITFIRE.  If
  846.         they are not found, SPITFIRE will run just the same.  Most of them can
  847.         be created using your favorite text editor.
  848.         
  849.         NO300   .BBS        - Displayed to 300 baud users when not allowed
  850.         SFPRELOG.BBS        - The first file displayed upon logon    (DISPLAY)
  851.         WELCOME1.BBS/CLR    - The second file displayed upon logon   (DISPLAY)
  852.         WELCOME[x].BBS/CLR  - Welcome2.BBS/CLR through Welcome9.BBS/CLR
  853.                               are displayed in numerical order after a user
  854.                               enters the name and password and gains access
  855.                               to the BBS.                            (DISPLAY)
  856.         NEWUSER .BBS/CLR    - Displayed to new user (normally rules of BBS)
  857.                                                                      (DISPLAY)
  858.         ALL     .BBS CLR    - The file that's displayed to all users upon 
  859.                               logon                                  (DISPLAY)
  860.         BULLETIN.BBS/CLR    - Lists the bulletins available to the user 
  861.                                                                      (DISPLAY)
  862.         BULLET[x].BBS/CLR   - [x] file is displayed when [x] bulletin is 
  863.                               selected.  Maximum of [x] is 99        (DISPLAY)
  864.         GOODBYE .BBS/CLR    - Displayed to user when logging off     (DISPLAY)
  865.         TOOMANY .BBS/CLR    - Displayed to user who exceeds daily limit of
  866.                               calls                                  (DISPLAY)
  867.         LOCKOUT .BBS/CLR    - Displayed to a user who is marked as locked out 
  868.                               or is found in JOKER.DAT               (DISPLAY)
  869.         NEEDSYS .BBS/CLR    - Displayed to user prior to terminating connection
  870.                               when utilizing the F1 key              (DISPLAY)
  871.         MAXUSERS.BBS/CLR    - Contains message sent to new user when maximum
  872.                               amount of users is met                 (DISPLAY)
  873.         DLMT    .BBS/CLR    - Displayed to user when downloads exceed daily
  874.                               limit                                  (DISPLAY)
  875.         PRIVATE  .BBS/CLR   - Contains message displayed to screen if running a
  876.                               private system and a new user attempts to log on
  877.                                                                      (DISPLAY)
  878.         SFPAGED  .BBS/CLR   - Displayed to screen if page goes unanswered
  879.                               or is toggled off                      (DISPLAY)
  880.         SFNWSLTR .BBS/CLR   - Sysop's newsletter available from the Main Menu
  881.                                                                      (DISPLAY)
  882.         SFRATIO  .BBS/CLR   - Displayed to user after a download if the user's
  883.                               download/upload ratio exceeds your setting
  884.                                                                      (DISPLAY)
  885.         [x]SEC   .BBS/CLR  - Displayed to all callers of [x] security level
  886.                                                                      (DISPLAY)
  887.         [x]      .BBS      - Displayed to caller of user record #[x] (DISPLAY)
  888.         SFUP     .BBS/CLR  - Displayed to user prior to an upload    (DISPLAY)
  889.  
  890.                                                                        Page 15
  891.         -----------------------------------------------------------------------
  892.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  893.         -----------------------------------------------------------------------
  894.         
  895.  
  896.         SFDOWN   .BBS/CLR  - Displayed to user prior to a download   (DISPLAY)
  897.         SFDOOR[x].BBS/CLR  - Displayed to user upon entering corresponding
  898.                              SPITFIRE Door program                   (DISPLAY)
  899.         SFDORBAK .BBS/CLR  - Displayed to user upon returning to SPITFIRE
  900.                              BBS after completing Door program       (DISPLAY)
  901.         SFNOTIME .BBS/CLR  - Displayed to user who attempts to logon after
  902.                              using their daily alloted time          (DISPLAY)
  903.         SFASLEEP .BBS/CLR  - Displayed to user who has not entered a key-
  904.                              stroke for three minutes, prior to logging
  905.                              them off the BBS.                       (DISPLAY)
  906.         SFTIMEUP .BBS/CLR  - Displayed to a user whose logon time has
  907.                              expired.                                (DISPLAY)
  908.         SFMQDONE .BBS/CLR  - Displayed to user who attempts to answer the
  909.                              current main questionnaire for a second time.
  910.                                                                      (DISPLAY)
  911.         CHATDONE .BBS/CLR  - Displayed to user upon completion of their chat
  912.                              with the Sysop.                         (DISPLAY)
  913.         USERINIT .BBS/CLR  - Displayed to user upon entering chat with the
  914.                              Sysop if the user paged the Sysop and requested
  915.                              the chat.                               (DISPLAY)
  916.         SYSINIT  .BBS/CLR  - Displayed to the user upon entering chat if the
  917.                              Sysop initiated the chat.               (DISPLAY)
  918.         MSGLIST  .BBS/CLR  - Displayed when the user responds to SPITFIRE's
  919.                              prompt to list message areas available on the
  920.                              BBS.                                    (DISPLAY)
  921.         SFMSG[x] .BBS/CLR  - Displayed to the user when selecting a specific
  922.                              message area. [x] would correspond to the area
  923.                              selected.                               (DISPLAY)
  924.         FILELIST .BBS/CLR  - Displayed when the user responds to SPITFIRE's
  925.                              prompt to list file areas available on the BBS.
  926.                                                                      (DISPLAY)
  927.         SFFILE[x].BBS/CLR  - Displayed to the user when selecting a specific
  928.                              file area.  [x] would correspond to the area
  929.                              selected.                               (DISPLAY)
  930.         SFBDAY   .BBS/CLR  - Displayed to a user on user's birthday  (DISPLAY)
  931.         SFPROMSG .BBS/CLR  - Displayed to the user prior to selecting a 
  932.                              default file transfer.  Sysops should use this
  933.                              display file to inform users that if a default
  934.                              transfer protocol is selected, External Transfer
  935.                              Procotcals will not be available to them.   
  936.                                                                      (DISPLAY)
  937.         THOUGHTS .BBS     -  Contains thoughts created for SPITFIRE by
  938.                              THOUGHTS.EXE                            (DISPLAY)
  939.         SFFILES  .BBS      - Display files which contain names of files 
  940.                              available for downloading in each of the file
  941.                              areas on the BBS.  This is the only exception to
  942.                              the rule of placing a Display File in the Display
  943.                              File Path.  Each SFFILES.BBS should be placed in 
  944.                              the corresponding file area.            (DISPLAY)
  945.  
  946.                                                                        Page 16
  947.         -----------------------------------------------------------------------
  948.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  949.         -----------------------------------------------------------------------
  950.         
  951.         
  952.  
  953.  
  954.         SFEXTDN  .BBS     -  Contains list of external download file transfer
  955.                              protocols available for use.            (DISPLAY)
  956.                              
  957.         SFEXTUP  .BBS     -  Contains list of external upload file transfer
  958.                              protocols available for use.            (DISPLAY)
  959.                              
  960.              SPITFIRE supports the use of Ansi/Graphics display files.  The
  961.         Ansi files use the file extension .CLR (color).  In the event you have
  962.         Ansi/Graphics available and SPITFIRE does not find the appropriate
  963.         .CLR file to display, then the appropriate .BBS file will be displayed.
  964.         If neither file is found, SPITFIRE will, in most cases, display a
  965.         default message.
  966.         
  967.              IMPORTANT:  When you create display files to be used with
  968.         SPITFIRE, you must NOT have lines in these files over 255 characters
  969.         long.  Further, if you make Ansi/Graphics available be sure to load the
  970.         ansi driver from within your CONFIG.SYS file.
  971.         
  972.              NOTE: If you are making ANSI graphics available to your callers,
  973.         you must duplicate all display [filename].BBS files to ANSI files and
  974.         call all of them [filename].CLR.  For an attractive BBS, you should
  975.         offer both sets of files.
  976.         
  977.              The following list of files are an EXCEPTION to this .CLR rule:
  978.         
  979.                                 THOUGHTS.BBS
  980.                                 SFFILES .BBS
  981.                                 SFPRELOG.BBS
  982.                                 NO300   .BBS
  983.                                 [x]     .BBS
  984.                                 
  985.  
  986.         3.3  SPITFIRE MENU FILES
  987.         ------------------------
  988.         
  989.              Menu files contain all the information needed for SPITFIRE to
  990.         dynamically build each caller's menus, dependent on the caller's
  991.         security level.
  992.         
  993.              SPITFIRE displays a function only if a caller's security level is
  994.         high enough to access it.  Therefore, a caller doesn't necessarily see
  995.         every possible choice in a given menu.  This places you in control and
  996.         allows you to tailor your board for your individual needs.
  997.         
  998.              The format used in SFMAIN.MNU, SFSYSOP.MNU, SFMSG.MNU & SFFILE.MNU
  999.         is:
  1000.  
  1001.                                                                        Page 17
  1002.         -----------------------------------------------------------------------
  1003.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1004.         -----------------------------------------------------------------------
  1005.         
  1006.         
  1007.  
  1008.      Command Character, Command Description,,Security Level,Command Identifier
  1009.              Knowing this, let's use the following example:
  1010.         
  1011.              B,<B>.... Bulletins,,5,A
  1012.              ------------------------
  1013.                  The "B" is the Command Character.  This will be the letter
  1014.                  your caller must type to access Bulletins.
  1015.         
  1016.                  "<B>.... Bulletins" is your Command Description.  This is how
  1017.                  your file entry will be displayed in your menu on the screen.
  1018.         
  1019.                  "5" is the minimum Security Level required for the caller to
  1020.                  access this function...or even see it!
  1021.         
  1022.                  "A" is the SPITFIRE Command Character Identifier and should
  1023.                  NEVER be changed.  The Command Character Identifier is 
  1024.                  constant in SPITFIRE programming.  This character will be 
  1025.                  DIFFERENT for every command.
  1026.         
  1027.  
  1028.  
  1029.              Once you've explored a bit, you'll find SPITFIRE allows you
  1030.         to design your menus to suit your own personal taste as well as control
  1031.         what commands are available to what users.  The SFFILE.MNU file that
  1032.         comes with the SPITFIRE package sets the <D>.... Download A File
  1033.         security at 10.  While a user is online, hit F2 and change a user's
  1034.         security to 9 and the Download feature is gone for that user.
  1035.         
  1036.              THERE ARE ONLY THREE RULES CONCERNING MENU LINES!:
  1037.              -------------------------------------------------
  1038.         
  1039.             You CANNOT change the Command Character Identifier from what it
  1040.             now is in the unchanged menu!                 
  1041.  
  1042.             You CANNOT assign the same Command Letter to two commands in the
  1043.             same menu!
  1044.  
  1045.             You CANNOT make the total length of the line more than 40
  1046.             characters long.
  1047.         
  1048.             Therefore, if you wanted, you could change Bulletins to read:
  1049.         
  1050.                  M,<M>.... Main Board,,5,A
  1051.         
  1052.             Or, perhaps...
  1053.         
  1054.                  A,<A>.... Announcements,,5,A
  1055.  
  1056.                                                                        Page 18
  1057.         -----------------------------------------------------------------------
  1058.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1059.         -----------------------------------------------------------------------
  1060.         
  1061.      
  1062.  
  1063.         
  1064.              Just remember: NEVER change the Command Character Identifier (the
  1065.         last character on each entry line), and NEVER use a Command Letter more
  1066.         than once in each menu.
  1067.  
  1068.              SPITFIRE uses the following Menu Files:
  1069.  
  1070.                   SFMAIN  .MNU   -  Main Menu              (SYSTEM)
  1071.                   SFMSG   .MNU   -  Message Menu           (SYSTEM)
  1072.                   SFFILE  .MNU   -  File Menu              (SYSTEM)
  1073.                   SFSYSOP .MNU   -  Sysop Menu             (SYSTEM)
  1074.                   SFDOOR  .MNU   -  Door Menu              (SYSTEM)
  1075.                   MAIN[x] .CLR   -  Color Main Menu        (DISPLAY)
  1076.                   MAIN[x] .BBS   -  Non-Ansi Main Menu     (DISPLAY)
  1077.                   FILE[x] .CLR   -  Color File Menu        (DISPLAY)
  1078.                   FILE[x] .BBS   -  Non-Ansi Main Menu     (DISPLAY) 
  1079.                   MSG[x]  .CLR   -  Color Message Menu     (DISPLAY)
  1080.                   MSG[x]  .BBS   -  Non-Ansi Message Menu  (DISPLAY)
  1081.                   SFDR[x] .CLR   -  Color Doors Menu       (DISPLAY)
  1082.                   SFDR[x] .BBS   -  Non-Ansi Doors Menu    (DISPLAY)
  1083.                   
  1084.              Refer to SPITFIRE DOORS section of this manual for information
  1085.         regarding the structure of SFDOOR.MNU.     
  1086.  
  1087.              You can use EDLIN or any text editor that can create ASCII files
  1088.         to edit these files.
  1089.         
  1090.              Should you edit these menu files and come up with some real nice
  1091.         looking menus, please advise so the information can be shared with
  1092.         other Sysops using SPITFIRE.
  1093.         
  1094.              SPITFIRE supports both color and Non-Ansi menus. The names of 
  1095.         the files displayed for the color menus are MAIN[x].CLR, FILE[x].CLR,
  1096.         MSG[x].CLR and SFDR[x].CLR.  The names of the Non-Ansi files displayed
  1097.         for the non color menus are MAIN[x].BBS, FILE[x].BBS, MSG[x].BBS, and
  1098.         SFDR[x].BBS.  The "x" represents the security level of the current
  1099.         caller.  For example, if a caller with a security level of 10 called
  1100.         and selected Ansi/Graphics, then SPITFIRE would look for files named
  1101.         MAIN10.CLR, FILE10.CLR, MSG10.CLR and SFDR10.CLR to display as the
  1102.         color menus.  If a caller with a security level of 10 called and
  1103.         choose not to use Ansi Graphics, then SPITFIRE would look for files
  1104.         named MAIN10.BBS, FILE10.BBS, MSG10.BBS and SFDR10.BBS.  In the event
  1105.         these files are not found, then SPITFIRE will display the regular menu.
  1106.         
  1107.               The reason for different color and Non-Ansi menu files for each 
  1108.         security level is to control what commands are shown to the user.  For
  1109.         example, if it takes a security level of 10 to be able to download a 
  1110.  
  1111.                                                                        Page 19
  1112.         -----------------------------------------------------------------------
  1113.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1114.         -----------------------------------------------------------------------
  1115.  
  1116.         
  1117.  
  1118.         file, then FILE10.CLR and FILE10.BBS would show the <D>... Download A 
  1119.         File command while FILE9.CLR and FILE9.BBS would not show the command.
  1120.         A color menu file and a Non-Ansi menu file will have to be created for
  1121.         each security level that you assign to users if you decide to have 
  1122.         SPITFIRE display created menus rather than having SPITFIRE build menus.
  1123.  
  1124.              Buffalo Creek Software provides a public domain utility to create
  1125.         the color and non color menu files.  The name of this utility is 
  1126.         MKSFMENU.EXE.  You can download it from Buffalo Creek's BBS at 
  1127.         515-225-8496.
  1128.  
  1129.              Sample MAIN10.CLR, FILE10.CLR, MSG10.CLR, MAIN10.BBS, FILE10.BBS
  1130.         and MSG10.BBS files are furnished with your SPITFIRE package.     
  1131.  
  1132.                                 
  1133.         3.4  SPITFIRE FILE CLARIFICATIONS
  1134.         ---------------------------------
  1135.         
  1136.              The following files are deserving of a more involved explanation
  1137.         than what is listed previously.
  1138.  
  1139.           DAILYLMT.DAT     - If you would like to set different DAILY time
  1140.              (SYSTEM)        limits according to the user's security level, you
  1141.                              want to use this file.
  1142.           The syntax is : 
  1143.          
  1144.         Security Level, Daily Time,,Daily Downloads,,,Daily Bytes,,,,Warning
  1145.         
  1146.           EXAMPLE:
  1147.           --------
  1148.            10,60,,10,,,500000,,,,Y   { 10 Security Level, 60 Minutes Per Day, 
  1149.                                      10 Downloads Per Day, 500,000 Bytes Per 
  1150.                                      Day, SFRATIO.BBS/CLR warning is displayed
  1151.                                      if the U/D ratio is exceeded }
  1152.                                      
  1153.            25,90,,15,,,1000000,,,,N  { 25 Security Level, 90 Minutes Per Day, 
  1154.                                      15 Downloads Per Day, 1,000,000 Bytes Per
  1155.                                      Day, SFRATIO.BBS/CLR warning is NOT
  1156.                                      displayed if the U/D ratio is exceeded }
  1157.         
  1158.         
  1159.           SFRATIO .BBS/CLR - It's rare when a caller's uploads exceed the
  1160.              (DISPLAY)       downloads.  Some users get in the habit of taking
  1161.                              and never give much consideration toward
  1162.                              uploading.  This file is displayed after a
  1163.                              download is completed that has tipped the scales
  1164.                              on the users' U/D ratio.  (This U/D ratio is set
  1165.  
  1166.                                                                         Page 20
  1167.         -----------------------------------------------------------------------
  1168.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1169.         -----------------------------------------------------------------------
  1170.         
  1171.         
  1172.         
  1173.                              at the SPITFIRE CONFIGURATION MENU, Command <15>).
  1174.                              SFRATIO will then be displayed, showing your
  1175.                              "friendly" words of advice to the user when this
  1176.                              situation presents itself.  If you are not 
  1177.                              concerned about a users' U/D ratio, simply don't 
  1178.                              include this file in your SF directory.  
  1179.  
  1180.           JOKER   .DAT     - JOKER.DAT contains a list of all names you don't
  1181.              (SYSTEM)        want to allow on your board.  Names like: Dr.
  1182.                              Phreak, Micro Muck, Lord Havoc, Nybbler, Killer,
  1183.                              etc..  You can create an ASCII file that has each
  1184.                              name listed on a separate line, such as:
  1185.  
  1186.                              Dr. Phreak
  1187.                              Micro Muck
  1188.                              Lord Havoc
  1189.                              Nybbler
  1190.                              Killer
  1191.                              All Users
  1192.         
  1193.           LOCKOUT .BBS/CLR - SPITFIRE reads JOKER.DAT line-by-line and compares
  1194.              (DISPLAY)       the names in the file against the caller's first 
  1195.                              and last name.  If a match is found, then the
  1196.                              LOCKOUT.BBS/CLR is displayed to the screen and the
  1197.                              caller is logged off!        
  1198.  
  1199.           SFNWSLTR.BBS/CLR - File which is displayed to callers when they 
  1200.              (DISPLAY)       request the <N>...Newsletter from the Main Menu.
  1201.                              This file can be used to send a special message 
  1202.                              to the users regarding the system.
  1203.  
  1204.           SFFILES .BBS/CLR - Used in each File Area for listing files
  1205.           (DL FILE AREA)     available for download in that area.  This file is
  1206.                              set up using your favorite text editor.  Here are
  1207.                              some guidelines one must follow for this to work
  1208.                              properly with SPITFIRE.
  1209.         
  1210.         SPITFIRE.ARC  325,000  10-22-88  SPITFIRE Bulletin Board System (V2.5)
  1211.         1--------10--------20--------30--------40--------50--------60--------70
  1212.         
  1213.              The FILENAME must begin at column 1
  1214.              The FILESIZE must end at column 21
  1215.              The FILEDATE must end at column 31
  1216.              The FILE DESCRIPTION must start at column 34
  1217.         
  1218.  
  1219.           NO300   .BBS    -  Displays this file to 300 baud callers, when 300
  1220.              (DISPLAY)       baud callers are not allowed.
  1221.  
  1222.                                                                         Page 21
  1223.         -----------------------------------------------------------------------
  1224.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1225.         -----------------------------------------------------------------------
  1226.         
  1227.         
  1228.  
  1229.         
  1230.           SFREMOTE.BAT    -  This batch file is used with the remote Drop to 
  1231.              (SYSTEM)        DOS feature and designed to be used with a carrier
  1232.                              detect utility such as WATCHDOG.  If connection
  1233.                              is terminated while a user is at the DOS level
  1234.                              the system is reset provided WATCHDOG is 
  1235.                              used.  If you have included SF.BAT in the 
  1236.                              AUTOEXEC.BAT, SPITFIRE will automatically boot on 
  1237.                              system start up.  WATCHDOG is recommended but is 
  1238.                              not included in the SPITFIRE package because it 
  1239.                              was written by another author (James R. Reinders, 
  1240.                              with minor modifications by Jim Kovalsky).
  1241.                              However, it may be downloaded from Buffalo Creek 
  1242.                              as well as from numerous other BBS systems.
  1243.  
  1244.           SF      .BAT     - Batch file used to invoke SPITFIRE.  This file
  1245.              (SYSTEM)        contains the necessary data for the scheduled 
  1246.                              events feature within SPITFIRE to work properly.
  1247.                              (See Section 12.1 for more infomation on Scheduled
  1248.                              Events.)  It also contains the data necessary
  1249.                              to execute programs using the SPITFIRE Door
  1250.                              feature.  (See Section 16.0 for more information
  1251.                              on SPITFIRE Doors.)
  1252.         
  1253.           SFPAGED .BBS/CLR - This file is displayed to the screen in the event 
  1254.              (DISPLAY)       a user has paged the sysop and either the page
  1255.                              was turned off or the sysop doesn't answer.
  1256.                            
  1257.           [x]SEC  .BBS/CLR - This feature is used so the sysop can send a 
  1258.              (DISPLAY)       special notice to all users of a certain security
  1259.                              level.  This file is not automatically erased.  
  1260.                              (x=The security level of the users to whom you 
  1261.                              wish to send the special message.)
  1262.         
  1263.           [x]     .BBS     - This feature is used so the sysop can send a 
  1264.              (DISPLAY)       special message to an individual user that will be
  1265.                              automatically erased once the user has received 
  1266.                              it.
  1267.         
  1268.             Example: John Doe is User Record # 95 on your system.  If you have
  1269.                      a file named "95.BBS", SPITFIRE will display this file 
  1270.                      when John Doe logs on and then erase it after it has been
  1271.                      received.  Your callers log will have a notation that the 
  1272.                      special message was sent.
  1273.  
  1274.                                                                         Page 22
  1275.         -----------------------------------------------------------------------
  1276.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1277.         -----------------------------------------------------------------------
  1278.         
  1279.         
  1280.             IMPORTANT NOTE: In the event you are using [x].BBS to send special
  1281.                             messages to users and you purge users from the 
  1282.                             users file by packing the users file, please
  1283.                             note that the [x].BBS may no longer match the
  1284.                             user that you intended the message for.
  1285.  
  1286.  
  1287.         3.5  ABOUT SPITFIRE DISPLAY FILES
  1288.         ---------------------------------
  1289.         
  1290.              As you can see, SPITFIRE allows you complete flexibility when it
  1291.         comes to displaying files.  The sysop has nearly total flexibility in
  1292.         making the board as unique as desired.
  1293.         
  1294.              There are a couple of features built into the display file
  1295.         routines which give you even more control.  They are:
  1296.         
  1297.                  ^B - Inhibits the display of the "More Prompt".
  1298.                  ^C - Disables the callers' ability break out of the display 
  1299.                  ^D - Displays user's first name
  1300.                  ^E - Enables the "More Prompt" if previously turned off by ^B
  1301.                  ^P - Exhibits a "More Prompt" in the display
  1302.                  
  1303.              Place these characters in your display file.  When SPITFIRE sees a
  1304.         ^B when displaying a file to the screen, then the <More?> prompt will
  1305.         not interrupt the display.  When SPITFIRE sees a ^C when displaying the
  1306.         file, then the user cannot abort the screen.  When SPITFIRE sees a ^D
  1307.         it will display the user's first name at that point in the display.
  1308.         The ^D should not be used inside a box.  It causes character spaces
  1309.         to be inserted when the name is entered which throws the box completely
  1310.         out of line.  When SPITFIRE sees a ^P the <More?> prompt is displayed 
  1311.         to the screen.  It should be mentioned that if a ^B is present in the 
  1312.         same display as a ^P, it will always override the ^P prompt, nulling
  1313.         the effect of the ^P feature.
  1314.         
  1315.                  ^B is the extended ASCII value of 002.
  1316.                  ^C is the extended ASCII value of 003.
  1317.                  ^D is the extended ASCII value of 004.
  1318.                  ^E is the extended ASCII value of 005.
  1319.                  ^P is the extended ASCII value of 016.             
  1320.                  
  1321.  
  1322.         3.6  BACKUP FILES
  1323.         -----------------
  1324.         
  1325.              When you perform sysop maintenance like Packing the Message Base
  1326.         or Packing the Users file, SPITFIRE will first make "Backup" copies for
  1327.         you.  If disk space is a problem on your board you could copy the
  1328.         backups to disk or discard them.  They are:
  1329.  
  1330.                                                                         Page 23
  1331.         -----------------------------------------------------------------------
  1332.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1333.         -----------------------------------------------------------------------
  1334.         
  1335.         
  1336.         
  1337.              SFMSG   .$PT - Message Pointer Backup File
  1338.              SFMSG   .$DA - Message Base Backup File
  1339.              SFUSERS .$$$ - Users Backup File
  1340.  
  1341.  
  1342.         3.7 THOUGHTS.BBS
  1343.         ----------------
  1344.         
  1345.              SPITFIRE will display a THOUGHT FOR THE DAY if a file named 
  1346.         THOUGHTS.BBS is found in the directory in you configured as your
  1347.         display file path.  The program to create THOUGHTS.BBS can be
  1348.         downloaded from Buffalo Creek's BBS at 515-225-8496 or you can
  1349.         download a ready-made THOUGHTS.BBS file.
  1350.  
  1351.  
  1352.         4.0  COMMAND LINE PARAMETERS
  1353.         ----------------------------
  1354.         
  1355.              Command Line Parameters can be used to make SPITFIRE start-up with
  1356.         a different configuration.  Command Line Parameters are what you type
  1357.         at the DOS prompt (or send to the program from a batch file) when you
  1358.         boot SPITFIRE.
  1359.         
  1360.                     /Cx -  Sets which COM port to use ([x] is com port).
  1361.                     /Ix -  Initializes the System speed ([x] is modem speed).
  1362.                     /M  -  Sets the initialization string used with your
  1363.                            modem.
  1364.                     /P  -  Sets the drive and directory used as the SPITFIRE
  1365.                            Work File Path.
  1366.                            
  1367.              The use of these Command Line Parameters is not necessary, except
  1368.         when you are originally booting SPITFIRE for the very first time and
  1369.         then only if you are using a comm port other than comm 1 and a speed
  1370.         different than 2400 baud.  In other words, SPITFIRE is written to
  1371.         default to comm port 1 and to initialize the system at 2400 baud so you
  1372.         will not have to use Command Line Parameters unless these defaults are
  1373.         different from what you plan to use while running SPITFIRE.
  1374.           
  1375.               SPITFIRE /C2 /I9600
  1376.         
  1377.              The above example would boot SPITFIRE utilizing COM port #2 and
  1378.         initializing the system at 9600 baud rate.
  1379.         
  1380.              It should also be mentioned that any Command Line Parameters    
  1381.         assigned from the DOS prompt or included in the SF.BAT file will
  1382.         override those set by using ALT+Z or ALT+P at the SPITFIRE "Ready
  1383.         Prompt".  Anytime a change is made in the baud rate, work path,
  1384.  
  1385.                                                                         Page 24
  1386.         -----------------------------------------------------------------------
  1387.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1388.         -----------------------------------------------------------------------
  1389.         
  1390.         
  1391.         modem initialization string or comm port assignment, you MUST also
  1392.         change the specifications you have set in the SF.BAT file.  This is
  1393.         the reason the use of command line parameters is not recommended.
  1394.  
  1395.  
  1396.         4.1  SF.BAT
  1397.         -----------
  1398.  
  1399.              It is advisable to use batch files when running SPITFIRE.  Here
  1400.         are some advantages:
  1401.         
  1402.                   - If an error occurs, and you're using the SF.BAT enclosed
  1403.                     with your SPITFIRE package, SPITFIRE will automatically
  1404.                     reset with the SF.BAT file.
  1405.         
  1406.                   - If you have your AUTOEXEC.BAT file written to automatically
  1407.                     boot SPITFIRE upon system startup and you have a power
  1408.                     outage, then SPITFIRE will automatically reboot when power
  1409.                     is restored.  If you should want to configure your
  1410.                     AUTOEXEC.BAT file to automatically boot SPITFIRE upon 
  1411.                     system startup then the last two commands in your 
  1412.                     AUTOEXEC.BAT file should look something like this:
  1413.  
  1414.                     CD\SF
  1415.                     SF
  1416.  
  1417.                     The above example assumes you are running SPITFIRE
  1418.                     on the drive you are booting from and you are running
  1419.                     SPITFIRE in a directory named SF.
  1420.  
  1421.         5.0  SETTING UP THE SYSTEM RECORDS
  1422.         -----------------------------------
  1423.         
  1424.              There are two ways to set up the system records in SPITFIRE.  The
  1425.         first way is at the "Ready..." prompt you can press ALT+R.  The second
  1426.         way is through the Sysop Menu.  Type '@' at the any menu for "Spitfire
  1427.         Sysop Utilities" and then select <4>.  You'll then see the following 
  1428.         menu:
  1429.  
  1430.         SYSTEM RECORD NUMBER 1
  1431.         Message Description : "SPITFIRE Message Area"
  1432.         Message Security    : 5
  1433.         Message Area Access : Equal To Or Greater Than User Security
  1434.         Public Message Area : All Messages Marked As Public
  1435.         File Download Path  : C:\SF
  1436.         File Upload Path    : C:\SF
  1437.         File Description    : "SPITFIRE File Area"
  1438.         File Security       : 5
  1439.         File Area Access    : Equal To Or Greater Than User Security
  1440.  
  1441.                                                                         Page 25
  1442.         -----------------------------------------------------------------------
  1443.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1444.         -----------------------------------------------------------------------
  1445.         
  1446.         
  1447.         SPITFIRE SYSTEM RECORD MENU
  1448.         <+> Next Record                    <-> Previous Record
  1449.         <M> Message Description            <F> File Description
  1450.         <U> Upload Path                    <D> Download Path
  1451.         <B> File Security                  <C> Message Security
  1452.         <#> Message Access                 <&> File Access
  1453.         <R> Record Number                  <A> Add New Record
  1454.         <P> Public/Private Message Area    <Q> Quit
  1455.         ENTER COMMAND - [+ - M F U D B C # & R A P Q]?
  1456.         
  1457.         
  1458.              Let's start by creating/modifying the first system record.  This
  1459.         is done by selecting the appropriate key (considering which part of the
  1460.         record you wish to modify).  M, F, U, D, B, C, #, &, R, A, P, and Q
  1461.         are all viable options at this point.
  1462.         
  1463.              You will notice that the default Message Area description is
  1464.         "SPITFIRE Message Area".  You will want to change this to suit your
  1465.         needs.  You may, for example, wish to change the Description of this
  1466.         area to "Public Messages".  Select <M> to make this change.
  1467.  
  1468.              The next thing you want to do is set the security level for this
  1469.         Message Area.  You will notice that the default security level is 5,
  1470.         which means that any user with a security of 5 or greater will be able
  1471.         to read messages in this area.  If you wish to set a different security
  1472.         level for this Message Area, then select <C> to change the security
  1473.         level of the area.
  1474.  
  1475.              You will note that SPITFIRE defaults the Message Area Access to
  1476.         "Equal To Or Greater Than".  What this means is that any user with a
  1477.         security level equal to or greater than the security level of this
  1478.         Message Area can access it.  If you select <#>, SPITFIRE will toggle
  1479.         this feature to "Equal To User Security". Then only users with a
  1480.         security level equal to the security level of the Message Area will be
  1481.         able to access this area.  Users with a security level greater than or
  1482.         less than the security level of this area will not be able to access
  1483.         this area save those users with sysop security.
  1484.  
  1485.              The next option available to you determines whether the Message
  1486.         Area will allow private messages.  The default setting of SPITFIRE
  1487.         allows private messages.  By selecting <P> you can toggle this feature
  1488.         so that messages are marked as public.
  1489.         
  1490.              Now you will notice that SPITFIRE sets the default download path
  1491.         to the directory where SPITFIRE resides.  To change this DOS filepath,
  1492.         select <D> to set the path for this File Area.  In the event that the
  1493.         filepath set does not exist, SPITFIRE will create it.  For example:  If
  1494.         you set your download path to C:\UTILITY and the utility directory
  1495.  
  1496.                                                                         Page 26
  1497.         -----------------------------------------------------------------------
  1498.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1499.         -----------------------------------------------------------------------
  1500.         
  1501.         
  1502.         doesn't exist on your drive, SPITFIRE will create the directory.  You
  1503.         will have to copy the files you want available for download into this
  1504.         directory and a SFFILES.BBS (textfile) listing the files in that
  1505.         directory.  SFFILES.BBS must also reside in that directory.  (A utility
  1506.         to create your SFFILES.BBS for each file directory is available for 
  1507.         download from Buffalo Creek - 515-225-8496.)    
  1508.  
  1509.              To change the upload path, you simply select <U> from the menu.
  1510.         The Upload and Download paths are any legal DOS pathnames telling 
  1511.         SPITFIRE where it can find the files associated with the File Area.  
  1512.         You can set uploads to go into a single "Upload file" area, or to 
  1513.         different areas which you could specify by subject.  Here are a few 
  1514.         examples of upload/download paths:
  1515.         
  1516.              The following would send the uploads to a sub-directory called
  1517.         "UPLOADS" and allow the caller to download programs from a
  1518.         sub-directory called "GOODIES".  (Note: SF is the parent directory.):
  1519.         
  1520.                            Upload Path.......C:\SF\UPLOADS
  1521.                            Download Path.....C:\SF\GOODIES
  1522.         
  1523.              The next example would send uploads to the same sub-directory
  1524.         where the files available for download exist:
  1525.         
  1526.                            Upload Path.......C:\SF\GOODIES
  1527.                            Download Path.....C:\SF\GOODIES
  1528.         
  1529.              If you're running on a floppy-based system with your uploads and
  1530.         download files on drive B, and not using sub-directories, you could do
  1531.         the following:
  1532.                            Upload Path.......B:\
  1533.                            Download Path.....B:\
  1534.         
  1535.              You will note that SPITFIRE defaults the File Area Access to
  1536.         "Equal To Or Greater Than".  What this means is that any user with a
  1537.         security level equal to or greater than the security level of this File
  1538.         Area can access it.  If you select <&>, SPITFIRE will toggle this
  1539.         feature to "Equal To User Security". Then only users with a security
  1540.         level equal to the security level of the File Area will be able to
  1541.         access this area.  Users with a security level greater than or less
  1542.         than the security level of this area will not be able to access the
  1543.         area save those users with sysop security.
  1544.                 
  1545.              After you've modified the present record, you are free to select
  1546.         <A> from the menu to <A>dd additional areas.  You can have a maximum of
  1547.         40 different Message and File Areas.
  1548.  
  1549.                                                                         Page 27
  1550.         -----------------------------------------------------------------------
  1551.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1552.         -----------------------------------------------------------------------
  1553.         
  1554.         
  1555.              A system record doesn't need to contain BOTH a File AND Message
  1556.         Area.  You can avoid the dilemma of coupling each Message Area with a
  1557.         File Area (and vice-versa) by simply setting either the File Area or
  1558.         Message Area (whichever is not desired) security level higher than
  1559.         any user's security level so callers can't access it or see it.
  1560.         
  1561.              When you're done, and the record is the way you want it, simply
  1562.         type <Q>.  SPITFIRE will automatically save your newly configured
  1563.         System Record.
  1564.         
  1565.         
  1566.         6.0  SPITFIRE QUESTIONNAIRES
  1567.         ----------------------------
  1568.         
  1569.              SPITFIRE uses a simple procedure to utilize Questionnaires.
  1570.         
  1571.              Questionnaires are simple text files that are interpreted by
  1572.         SPITFIRE.  Any line in the file will simply be displayed to the user
  1573.         unless the first character in the line is a colon ":".  If the first
  1574.         character in the line is a colon, then SPITFIRE displays the line and
  1575.         then pauses and waits for user input.
  1576.         
  1577.              Listed below is an example.  Suppose you wish to create a poll of
  1578.         what types of files your users prefer to download. Such a questionnaire
  1579.         might look like this:
  1580.         
  1581.         :What type of files interest you for download? (Games, utilities, etc.)
  1582.         Thanks for your input!
  1583.         
  1584.              If your questionnaire looks like the above example, then SPITFIRE
  1585.         will show the first line to the user, pause for user input and will
  1586.         display the "Thanks..." message after the user has answered the
  1587.         question.  The user's answer is written to either SFNEWU.ANS or
  1588.         SFMAIN.ANS, depending upon which questionnaire the user is replying
  1589.         to.  In addition to the user's answers, the user's name, date and time
  1590.         of the response is recorded within the same file.
  1591.              There are 2 questionnaires available for use in SPITFIRE:
  1592.         
  1593.         -----------------------------------------------------------------------
  1594.                                   _
  1595.           This is the NEWUSER ___/ SFNEWU  .QUE    The questionnaire file
  1596.              Questionnaire       \_SFNEWU  .ANS    The answer file
  1597.         
  1598.         This is automatically displayed ONLY when a new user logs on.
  1599.                 
  1600.  
  1601.                                                                         Page 28
  1602.         -----------------------------------------------------------------------
  1603.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1604.         -----------------------------------------------------------------------
  1605.         
  1606.       
  1607.                                   _
  1608.            This is the POLL   ___/ SFMAIN  .QUE    Poll questionnaire file
  1609.              Questionnaire       \_SFMAIN  .ANS    Poll answer file
  1610.         
  1611.         This is utilized only from the MAIN MENU with <V>.. Voice Your Opinion.
  1612.         
  1613.              Answers are appended to the end of the appropriate answer file.
  1614.         If the file does not already exist, SPITFIRE will create it.
  1615.  
  1616.              SPITFIRE requires the user to respond to the questions in the
  1617.         questionnaire files before it continues. 
  1618.         
  1619.  
  1620.         7.0  THE FUNCTION KEYS
  1621.         ----------------------
  1622.         
  1623.                               F1   -  Log User Off With Message
  1624.                               F2   -  Change Security Level
  1625.                               F3   -  Toggle Sysop Page/Prompt
  1626.                               F4   -  Toggle Printer      
  1627.                               F5   -  Check Today's Statistics
  1628.                               F6   -  Take Five Minutes From User
  1629.                               F7   -  Give Five Minutes To User
  1630.                               F8   -  Toggle Screen
  1631.                               F9   -  Log User Off
  1632.                               F10  -  Quit SPITFIRE
  1633.  
  1634.  
  1635.         7.1  FUNCTION KEY DEFINITIONS:
  1636.         ------------------------------
  1637.         
  1638.              F1 (Log User Off With Message)
  1639.              -----------------------------
  1640.  
  1641.              Displays NEEDSYS.BBS/.CLR and logs user off.  If a user is ONLINE
  1642.         and you need to access your system, pressing F1 displays your message
  1643.         via the NEEDSYS.BBS/.CLR screen and terminates the connection.
  1644.  
  1645.              F2 (Change Security Level)
  1646.              -------------------------
  1647.  
  1648.              If a user is ONLINE and you wish to change the user's security
  1649.         level, you can change it by pressing F2.  The user is unable to see
  1650.         that you are changing the security level.
  1651.  
  1652.                                                                         Page 29
  1653.         -----------------------------------------------------------------------
  1654.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1655.         -----------------------------------------------------------------------
  1656.         
  1657.         
  1658.              F3 (Toggle Sysop Page)
  1659.              ----------------------
  1660.  
  1661.              By toggling this parameter [ON or OFF] the sysop can decide
  1662.         whether or not to be paged.  If the PAGE is ON, the words "PAGE ON"
  1663.         will appear on the top of your screen, provided you are using the split
  1664.         screen.  If the page is turned on and a user selects <P> for page, then
  1665.         the prompt bell will sound to notify you that a user wishes to chat 
  1666.         with you.  USERINIT.BBS/CLR will be displayed to the screen when you
  1667.         respond to the page.  If the PAGE is turned off and a user pages you, 
  1668.         then SFPAGED.BBS/CLR will be displayed to the user and you will not be
  1669.         notified of the Page.
  1670.         
  1671.              F4 (Toggle Printer)
  1672.              -------------------
  1673.              This allows you to toggle the printer ON/OFF.  Everything that
  1674.         is written to the CALLERS.LOG will also be sent to the printer if
  1675.         this toggle is on. This is useful if you wish to retain a hard copy
  1676.         of your users' activities while online.  Keep in mind that your 
  1677.         printer must be turned on and ready for use.  SPITFIRE checks to 
  1678.         determine if your printer is properly connected and ready for use
  1679.         and responds accordingly.
  1680.  
  1681.              F5 (Check Today's Statistics)
  1682.              -----------------------------
  1683.              While at the "SPITFIRE ready for caller prompt...", if you press
  1684.         F5, SPITFIRE will display the name of the last caller, number of calls
  1685.         for the day, number of uploads for the day and so on...
  1686.         
  1687.              F6 (Take Five Minutes from a User)
  1688.              ----------------------------------
  1689.              When a user is online, you can take 5 minutes from the user's
  1690.         log-on time by pressing F6.  If you press F6 in multiples, then
  1691.         multiples of 5 minutes are taken from the user's time.
  1692.         
  1693.              F7 (Give Five Minutes to a User)
  1694.              --------------------------------
  1695.              When a user is online, you can give 5 minutes to the user's log-on
  1696.         time.  If you press F7 in multiples, then multiples of 5 minutes are
  1697.         added to the user's time.
  1698.  
  1699.              F8 (Toggle Screen)
  1700.              ------------------
  1701.              This feature is used to toggle the split-screen/full-screen
  1702.         option.  This feature can be utilized at either the "SPITFIRE ready for
  1703.         caller..." prompt or when a user is online.
  1704.  
  1705.                                                                         Page 30
  1706.         -----------------------------------------------------------------------
  1707.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1708.         -----------------------------------------------------------------------
  1709.         
  1710.         
  1711.         
  1712.              F9 (Log User Off)
  1713.              -----------------
  1714.              If a user is ONLINE and you wish to disconnect this user, simply
  1715.         press F9 and the connection will be terminated.
  1716.         
  1717.              F10 (Terminate SPITFIRE)
  1718.              ------------------------
  1719.              Pressing F10 will terminate SPITFIRE and returns you to DOS.
  1720.              
  1721.                      
  1722.         8.0  THE ALT KEYS
  1723.         -----------------
  1724.         
  1725.              SPITFIRE uses the ALT key in combination with a letter key for
  1726.         many of its commands.  Here is a list of the ALT keys used by SPITFIRE:
  1727.         
  1728.  
  1729.         8.1  AVAILABLE KEYS
  1730.         -------------------
  1731.         
  1732.                            ALT+A  -  Maintains Users File
  1733.                            ALT+C  -  Enter/Exit Chat Mode
  1734.                            ALT+J  -  Jump to DOS
  1735.                            ALT+M  -  Configure Modem
  1736.                            ALT+P  -  Configure File Paths
  1737.                            ALT+R  -  Configure System Records
  1738.                            ALT+S  -  Sysop Sign-On/Sysop Next
  1739.                            ALT+Q  -  Sysop Quick Log-On/Sysop Next
  1740.                            ALT+Z  -  Configure SPITFIRE
  1741.                            HOME   -  SPITFIRE Sysop Help Screen
  1742.         
  1743.              The HOME key feature is available only at the "SPITFIRE ready for
  1744.         caller..." prompt.
  1745.         
  1746.                         _________
  1747.                        /         \
  1748.                     __/ -+ KEY +- \__________________________________________
  1749.                    |                                                         |
  1750.                    |  [O] - User must be ON-LINE to perform                  |
  1751.                    |  [R] - SPITFIRE must be "Ready for caller" to perform   |
  1752.                    |  [B] - Can be used BOTH when a user's online or not.    |
  1753.                    |_________________________________________________________|
  1754.  
  1755.              To use an ALT+Key, the ALT key and the appropriate letter key must
  1756.         be pressed simultaneously. (First, press down the ALT key, then, while
  1757.         holding the ALT key down, press the letter key.)
  1758.  
  1759.                                                                         Page 31
  1760.         -----------------------------------------------------------------------
  1761.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1762.         -----------------------------------------------------------------------
  1763.         
  1764.  
  1765.  
  1766.         8.2  ALT KEY DEFINITIONS
  1767.         ------------------------
  1768.         
  1769.              [R]  ALT+A  (Maintain Users File)
  1770.              ---------------------------------
  1771.              At the "Ready..." prompt, when you select ALT+A, you can maintain
  1772.         the user's file, rather than logging and maintaining the users file
  1773.         from the Sysop Menu.
  1774.         
  1775.              [O]  ALT+C  (Enter/Exit Chat Mode)
  1776.              ----------------------------------
  1777.              This feature is for entering and exiting chat with a user.  You
  1778.         can use this feature to answer a page or force a user into chat.  When
  1779.         you answer a page, the caller's time online is still ticking away.
  1780.         However, when you force a user into chat, the user's time online
  1781.         counter is halted until the chat is finished and the user is returned
  1782.         to the system.
  1783.         
  1784.              [B]  ALT+J  (Jump to DOS)
  1785.              -------------------------
  1786.              This feature allows you to jump to DOS when you have a user online
  1787.         and also when you are at the "Ready..." prompt.  When you wish to go
  1788.         back to SPITFIRE, type EXIT.  If you are not in the proper directory
  1789.         when you EXIT, SPITFIRE will automatically take you back to the
  1790.         directory in which SPITFIRE resides.
  1791.  
  1792.              [R]  ALT+M  (Configure Modem)
  1793.              -----------------------------
  1794.              This feature allows you to configure your modem initialization
  1795.         string, COM port and Numeric result codes.  You will also notice a
  1796.         toggle switch for use of an error-checking modem.  If you are using an
  1797.         error-checking modem, be sure to turn this switch ON.  If you are using
  1798.         an error-checking modem and this switch isn't turned on, when a caller
  1799.         logs on with an error-checking modem, the Ymodem-g transfer protocols
  1800.         will not be available to the user.
  1801.         
  1802.              In the event your modem requires an initialization string
  1803.         different than those listed in this manual, please advise by calling 
  1804.         Buffalo Creek's BBS (515-225-8496), so that the information can be 
  1805.         passed on to other sysops.
  1806.  
  1807.              [R]  ALT+P  (Configure File Paths)
  1808.              ---------------------------------
  1809.              Pressing the ALT+P at the "SPITFIRE ready for caller..." prompt
  1810.         opens a window which allows you to configure the File Paths you are
  1811.         using and set whether you are using the External File Transfer 
  1812.         Protocols on your system.  (For more information on this, refer to
  1813.         Section 2.5 - File Paths.)
  1814.  
  1815.                                                                         Page 32
  1816.         -----------------------------------------------------------------------
  1817.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1818.         -----------------------------------------------------------------------
  1819.         
  1820.         
  1821.         
  1822.              [R]  ALT+R  (Configure System Records)
  1823.              --------------------------------------
  1824.              While SPITFIRE is at the "SPITFIRE ready for caller.." prompt, you
  1825.         can select ALT+R to configure your Message and File Areas.  This
  1826.         feature allows you to do so without having to go through the motions of
  1827.         logging on as Sysop and using the Sysop menu to make these changes.
  1828.         Refer to Section 5.0 for detailed information regarding configuring
  1829.         your system records.
  1830.         
  1831.              [B]  ALT+S  (Log On Locally/Sysop Next)
  1832.              --------------------------------------
  1833.              This feature is used to log on SPITFIRE locally.  It can be used
  1834.         at the "Ready..." prompt or while a user is online.  If you utilize
  1835.         this feature while a user is online, then when the user logs off, you
  1836.         are able to log-on immediately afterward.  Logging on with ALT+S
  1837.         will display the same initial log on display files which are displayed
  1838.         to the remote users on the BBS, such as PRELOG.BBS, WELCOME1.BBS/CLR,
  1839.         through WELCOME9.BBS/CLR and All.BBS/CLR.
  1840.         
  1841.  
  1842.              [B]  ALT+Q  (Sysop Quick Log-On/Sysop Next)
  1843.              -------------------------------------------
  1844.              This feature is used to log on SPITFIRE locally.  It can be used
  1845.         at the "Ready..." prompt or while a user is online.  If you utilize
  1846.         this feature while a user is online, then when the user logs off, you
  1847.         are able to log-on immediately afterward.  Logging on with ALT+Q
  1848.         will not display the initial log on display files, but rather take
  1849.         you right to the Main Menu after entering your name and password.
  1850.         
  1851.              [R]  ALT+Z  (Configure SPITFIRE)
  1852.              --------------------------------
  1853.              This feature is used to configure certain aspects of SPITFIRE.
  1854.         Refer to Section 2.4, Part 5 for detailed information regarding this
  1855.         portion of the SPITFIRE configuration.
  1856.         
  1857.         "HOME" - Displays a quick summary of all keys available to the Sysop.
  1858.  
  1859.  
  1860.         9.0  MAIN MENU EXPLAINED
  1861.         ------------------------
  1862.  
  1863.              The Main Menu is the crux of any system, being that all major
  1864.         areas of the BBS are to be accessed from this area.  However, it is
  1865.         important to note that a user does not have to return to the Main Menu
  1866.         from the Message Section to go to the File Section (and vice-versa). 
  1867.         In the event there is a command on the Main Menu that you do not have
  1868.  
  1869.                                                                         Page 33
  1870.         -----------------------------------------------------------------------
  1871.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1872.         -----------------------------------------------------------------------
  1873.         
  1874.         
  1875.  
  1876.         functional, set the security level of that command high enough so
  1877.         users cannot see it.
  1878.         
  1879.              As the Main Menu is described and the features explained, please
  1880.         keep in mind that you can control the usage of each command by changing
  1881.         the security level of the commands.  In other words, you can control
  1882.         what commands are available to what users.  (i.e. - If the security
  1883.         level of the  <B>.... Bulletins command is set at 25 then a user with
  1884.         a security level of 24 or less would not see the command or be able to
  1885.         use the command.)
  1886.         
  1887.              The Main Menu is the first focal point your callers will see after
  1888.         they have gone through the log-on screens.  For the purpose of
  1889.         discussion, each menu displayed will be as if the sysop (with the
  1890.         highest security level) were viewing it.  In this case the Main Menu
  1891.         would look like this:
  1892.         
  1893.         9.1  MAIN MENU EXAMPLE
  1894.         ----------------------
  1895.         
  1896.         >>>>>>>> SPITFIRE MAIN MENU <<<<<<<<
  1897.         <M>.... Message Section            <F>.... Files Section
  1898.         <S>.... SPITFIRE Doors             <B>.... Bulletins
  1899.         <C>.... Comment to Sysop           <#>.... List Active Users      
  1900.         <L>.... Locate a User              <I>.... Initial Welcome        
  1901.         <V>.... Voice Your Opinion         <T>.... This System's Information 
  1902.         <N>.... Newsletter                 <P>.... Page the Sysop  
  1903.         <G>.... Goodbye & Log Off          <X>.... Xpert Mode Toggle
  1904.         <Y>.... Your Statistics            <O>.... Other Bulletin Boards 
  1905.         <A>.... Add BBS Name & #           <@>.... Sysop Utilities            
  1906.         <?>.... HELP with Commands         <^D>... CTRL-D Macro
  1907.         <^U>... CTRL-U Macro
  1908.         
  1909.         MAIN MENU - [M F S B C # L I V T N P G X Y O A @ ? ^D ^U]?
  1910.  
  1911.         9.2  EXPLANATION OF MAIN MENU FEATURES
  1912.         --------------------------------------
  1913.         
  1914.           <M>.... Message Section
  1915.                   This feature takes a user from the MAIN section of SPITFIRE
  1916.                   to the MESSAGE section.
  1917.  
  1918.           <F>.... Files Section
  1919.                   This feature takes a user from the MAIN section of SPITFIRE
  1920.                   to the FILE section.
  1921.  
  1922.                                                                         Page 34
  1923.         -----------------------------------------------------------------------
  1924.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1925.         -----------------------------------------------------------------------
  1926.         
  1927.         
  1928.  
  1929.         
  1930.                   
  1931.           <S>.... SPITFIRE Doors
  1932.                   This feature allows a caller to terminate SPITFIRE so a
  1933.                   third party program can be run online.  Normally, but not
  1934.                   always, the third party program is a game.  When the third
  1935.                   party program is finished, the caller is returned to
  1936.                   SPITFIRE.
  1937.  
  1938.           <B>.... Bulletins
  1939.                   This feature allows a user to read the available bulletins.
  1940.  
  1941.           <C>.... Comment to Sysop
  1942.                   Allows a user to enter a private message to the Sysop.  All
  1943.                   comments are automatically saved to Message Area #1.
  1944.                                     
  1945.           <#>.... List Active Users
  1946.                   This feature will scroll the name and address of each user of
  1947.                   this BBS.  It also shows the last date each user logged on.
  1948.         
  1949.           <L>.... Locate a User
  1950.                   This feature allows a user to see if a certain person is a
  1951.                   user on this BBS.  For example, if a user selects this 
  1952.                   feature, then the user will be asked for a name.  After a 
  1953.                   user enters a name, SPITFIRE will check to see if that 
  1954.                   person is a user of this BBS.  SPITFIRE will advise the user
  1955.                   as to whether the person is a user or not.  If the last name
  1956.                   can not be matched with a current user, SPITFIRE provides 
  1957.                   the option of continuing to search for a user with the first
  1958.                   name and last name initial corresponding to what was 
  1959.                   previously entered.
  1960.         
  1961.           <I>.... Initial Welcome
  1962.                   This feature allows a user to review the opening screen.
  1963.         
  1964.           <V>.... Voice Your Opinion
  1965.                   This feature allows you to poll your users on any issue you
  1966.                   consider of relevance to your system.  This feature works in
  1967.                   conjunction with SFMAIN.QUE.
  1968.         
  1969.           <T>.... This System's Info
  1970.                   This feature will show a user certain information about the
  1971.                   BBS.
  1972.         
  1973.           <N>.... Newsletter
  1974.                   This feature will display SFNWSLTR.BBS (your BBS newsletter)
  1975.                   to the user.  This can be used to keep the users updated with
  1976.                   changes or news concerning your BBS.
  1977.  
  1978.                                                                         Page 35
  1979.         -----------------------------------------------------------------------
  1980.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  1981.         -----------------------------------------------------------------------
  1982.         
  1983.         
  1984.  
  1985.  
  1986.           <P>.... Page the Sysop
  1987.                   This feature notifies the Sysop that a user has a question
  1988.                   or problem to visit about.
  1989.         
  1990.           <G>.... Goodbye & Log Off
  1991.                   This feature simply allows a user to log off the BBS.
  1992.  
  1993.           <X>.... Xpert Mode Toggle
  1994.                   This feature changes a user's status from a novice to an
  1995.                   expert or vice versa.  If a user is set as a novice, then
  1996.                   the menu descriptions will scroll by after each command.  If
  1997.                   a user is set as an expert, then only the command letters
  1998.                   scroll by after each command. 
  1999.         
  2000.           <Y>.... Your Statistics
  2001.                   This feature displays certain user's statistics on this BBS
  2002.                   and allows a user the opportunity to change some of them.  
  2003.                   For example, this is where a user can change the keystroke 
  2004.                   feature and where a user can write macros.
  2005.         
  2006.           <O>.... Other Bulletin Boards
  2007.                   This feature will display the names and phone numbers of
  2008.                   other Bulletin Boards.
  2009.                   
  2010.           <A>.... Add BBS Name & #
  2011.                   This feature allows a user to add a name and phone number to
  2012.                   the BBS list described above.
  2013.         
  2014.           <@>.... Sysop Utilities
  2015.                   This feature takes a user from the MAIN section to the SYSOP
  2016.                   section.  The BBS is maintained from the SYSOP section.  This
  2017.                   feature is not normally available to most users.
  2018.         
  2019.           <?>.... HELP with Commands
  2020.                   This feature will provide help for each command available
  2021.                   from the MAIN MENU.
  2022.         
  2023.           <^D>... CTRL-D Macro
  2024.                   Executes the ^D macro a user has written.  This feature only
  2025.                   works if the user has written a macro.
  2026.         
  2027.           <^U>... CTRL-U Macro
  2028.                   Executes the ^U macro a user has written.  This feature only
  2029.                   works if the user has written a macro.
  2030.  
  2031.                                                                         Page 36
  2032.         -----------------------------------------------------------------------
  2033.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2034.         -----------------------------------------------------------------------
  2035.         
  2036.         
  2037.  
  2038.         10.0  MESSAGE MENU EXPLAINED
  2039.         ----------------------------
  2040.         
  2041.              The Message Menu is the point from which your callers take part in
  2042.         mail exchange.  The first time they visit this area SPITFIRE will check
  2043.         to see the messages they have left and notify them of the last message
  2044.         they have read when they choose to read messages.
  2045.  
  2046.  
  2047.         10.1  MESSAGE MENU EXAMPLE
  2048.         --------------------------
  2049.         
  2050.         >>>>>>>> SPITFIRE MESSAGE MENU <<<<<<<<
  2051.         <C>.... Change Message Menu        <R>.... Read Messages
  2052.         <H>.... Hurry Scan Messages        <B>.... Browse Messages
  2053.         <N>.... Non-stop Message Capture   <E>.... Enter A Message
  2054.         <Y>.... Your Messages              <L>.... Locate A User
  2055.         <D>.... Delete a Message           <T>.... Text Search 
  2056.         <F>.... File Section               <P>.... Page the Sysop 
  2057.         <Q>.... Quit to MAIN MENU          <S>.... SPITFIRE Doors 
  2058.         <X>.... Xpert Mode Toggle          <G>.... Goodbye & Log Off          
  2059.         <@>.... Sysop Utilities            <?>.... HELP with Commands
  2060.         <^D>... CTRL-D Macro               <^U>... CTRL-U Macro
  2061.         
  2062.         MESSAGE MENU - [C R H B N E Y L D T F P Q S X G @ ? ^D ^U]?
  2063.  
  2064.  
  2065.         10.2  MESSAGE MENU EXPLANATION
  2066.         ------------------------------
  2067.         
  2068.           <C>.... Change Message Area
  2069.                   This feature allows a user to change to a different Message
  2070.                   Area.  If a user selects <Q>uit, the user will remain in your
  2071.                   present Message Area.  If a user presses the ENTER key,
  2072.                   SPITFIRE will list the Message Areas available to the user.
  2073.                   If a MSGLIST.BBS/CLR is found it will be displayed here.
  2074.                   
  2075.           <R>.... Read Messages
  2076.                   This feature allows a user to read public messages in a
  2077.                   specific Message Area or in all Message Areas.  The user can
  2078.                   start reading the messages at a specific message or at the
  2079.                   last message the user read.
  2080.         
  2081.           <H>.... Hurry Scan Messages
  2082.                   This feature allows a user to scan messages in a specific
  2083.                   Message Area or in all Message Areas.  This scan doesn't
  2084.                   provide as much information regarding the messages as the
  2085.                   <B>rowse Messages feature.
  2086.  
  2087.                                                                         Page 37
  2088.         -----------------------------------------------------------------------
  2089.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2090.         -----------------------------------------------------------------------
  2091.         
  2092.         
  2093.         
  2094.           <B>.... Browse Messages
  2095.                   This feature allows a user to scan messages in a specific
  2096.                   Message Area or in all Message Areas.  This scan provides
  2097.                   the user with more information regarding the messages than
  2098.                   the <H>urry Scan Messages feature.
  2099.  
  2100.           <N>.... Non-stop Message Capture
  2101.                   When this feature is executed, SPITFIRE will display all
  2102.                   appropriate messages non-stop.  The caller normally uses
  2103.                   some means to capture the messages for later reading or 
  2104.                   printing.
  2105.                   
  2106.           <E>.... Enter A Message
  2107.                   This feature allows a user to enter a message.  If the
  2108.                   message the user enters is not to a specific person, then
  2109.                   SPITFIRE addresses the message to "All Users".  If the 
  2110.                   message is to a specific person and that person is not a 
  2111.                   user of this BBS, then SPITFIRE will not allow the user to 
  2112.                   enter the message.  Users are allowed to send carbon copies 
  2113.                   of a message to other users.  There are a total of three 
  2114.                   carbon copies available.  There are a total of 50 lines per 
  2115.                   message.  When entering (or responding) to a message, 
  2116.                   SPITFIRE will display the Message Areas available to you 
  2117.                   and whether a specific Message Area allows public or 
  2118.                   public/private messages.
  2119.         
  2120.           <Y>.... Your Messages
  2121.                   This feature searches all Message Areas for messages
  2122.                   addressed to the user.  If any messages are found, then
  2123.                   SPITFIRE shows the user the messages.  If there are no 
  2124.                   messages found, then SPITFIRE notifies the user that there 
  2125.                   are no messages waiting for the user.
  2126.                   
  2127.           <L>.... Locate A User
  2128.                   This feature allows a user to see if a certain person is a
  2129.                   user on this BBS.  For example, if the user selects this
  2130.                   feature, the user will be asked for a name.  After entering a
  2131.                   name then SPITFIRE will check to see if that person is a user
  2132.                   of this BBS.  If the last name can not be matched with a
  2133.                   current user, SPITFIRE provides the option of continuing to
  2134.                   search for a user with the first name and last initial that
  2135.                   corresponding to what was previously entered.
  2136.         
  2137.           <D>.... Delete a Message
  2138.                   This feature allows a user to delete a message the user
  2139.                   has entered or is addressed to the user.
  2140.  
  2141.                                                                         Page 38
  2142.         -----------------------------------------------------------------------
  2143.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2144.         -----------------------------------------------------------------------
  2145.         
  2146.         
  2147.  
  2148.           <T>.... Text Search
  2149.                   This feature allows a user to search for specific text in a
  2150.                   message.  The user can decide to search for the text within
  2151.                   messages in a specific Message Area only or all Message 
  2152.                   Areas.  This feature will only search the user's messages 
  2153.                   and public messages.
  2154.         
  2155.           <F>.... File Section
  2156.                   This feature takes the user from the MESSAGE section of
  2157.                   SPITFIRE to the FILE section.
  2158.  
  2159.           <P>.... Page the Sysop
  2160.                   This feature notifies the Sysop that a user has a question
  2161.                   or problem to visit about.
  2162.  
  2163.           <Q>.... Quit to MAIN MENU
  2164.                   This feature takes a user from the MESSAGE section of
  2165.                   SPITFIRE to the MAIN section.
  2166.  
  2167.           <S>.... SPITFIRE Doors
  2168.                   This feature allows a caller to terminate SPITFIRE so a
  2169.                   third party program can be run online.  Normally, but not
  2170.                   always, the third party program is a game.  When finished
  2171.                   with the third party program, the caller is returned
  2172.                   to SPITFIRE.
  2173.  
  2174.           <X>.... Xpert Mode Toggle
  2175.                   This feature changes a user's status from a novice to an
  2176.                   expert or vice versa.  If a user is set as a novice, then
  2177.                   the menu descriptions will scroll by after each command.  If
  2178.                   a user is set as an expert, then only the command letters
  2179.                   scroll by after each command.
  2180.  
  2181.           <G>.... Goodbye & Log Off
  2182.                   This feature simply allows a user to log off the BBS.
  2183.                 
  2184.           <@>.... Sysop Utilities
  2185.                   This feature takes a user from the MESSAGE section to the
  2186.                   SYSOP section.  The BBS is maintained from the SYSOP section.
  2187.                           
  2188.           <?>.... HELP with Commands
  2189.                   This feature will provide help for each command available
  2190.                   from the MESSAGE MENU.
  2191.         
  2192.           <^D>... CTRL-D Macro
  2193.                   Executes the ^D macro a user has written.  This feature only
  2194.                   works if the user has written a macro.
  2195.  
  2196.           <^U>... CTRL-U Macro
  2197.                   Executes the ^U macro a user has written.  This feature only
  2198.                   works if the user has written a macro.
  2199.  
  2200.                                                                         Page 39
  2201.         -----------------------------------------------------------------------
  2202.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2203.         -----------------------------------------------------------------------
  2204.         
  2205.         
  2206.  
  2207.         11.0  FILE MENU EXAMPLE
  2208.         -----------------------
  2209.         
  2210.         >>>>>>>> SPITFIRE FILE MENU <<<<<<<<
  2211.         <C>.... Change File Area           <L>.... List Files In This Area
  2212.         <E>.... Erase A File               <G>.... Goodbye & Log Off
  2213.         <D>.... Download a File            <U>.... Upload a File
  2214.         <H>.... Help on Upload/Download    <P>.... Page the Sysop
  2215.         <M>.... Message Section            <Q>.... Quit to MAIN MENU
  2216.         <S>.... SPITFIRE Doors             <N>.... New Files
  2217.         <T>.... Text Search Description    <F>.... Find A File
  2218.         <X>.... Xpert Mode Toggle          <?>.... HELP with Commands         
  2219.         <@>.... Sysop Utilities            <W>.... What's In An .ARC File
  2220.         <V>.... View A Text File           <^D>... CTRL-D Macro
  2221.         <^U>... CTRL-U Macro
  2222.         
  2223.         FILE MENU - [C L E G D U H P M Q S N T F X ? @ W V ^D ^U]?
  2224.  
  2225.  
  2226.         11.1  FILE MENU EXPLANATION
  2227.         ---------------------------
  2228.         
  2229.           <C>.... Change File Area
  2230.                   This feature allows a user to change to a different File
  2231.                   Area.  If the user selects <Q>uit, the user will remain in
  2232.                   the same current File Area.  If the user presses the ENTER
  2233.                   key, SPITFIRE will list the File Areas available to the user.
  2234.         
  2235.           <L>.... List Files In This Area
  2236.                   This feature will display the files (SFFILES.BBS) in the
  2237.                   current File Area that are available for the user to 
  2238.                   download.
  2239.                   
  2240.           <E>.... Erase A File
  2241.                   This feature allows a user the ability to erase a file from a
  2242.                   File Area.  Normally this feature is only available to users
  2243.                   with Sysop security.
  2244.  
  2245.           <G>.... Goodbye & Log Off
  2246.                   This feature simply allows a user to log off the BBS.
  2247.  
  2248.           <D>.... Download a File
  2249.                   This feature simply allows a user the opportunity to download
  2250.                   a file, provided the user hasn't exceeded the maximum daily
  2251.                   download limit and provided the user has enough time left to
  2252.                   make the download.  The user does not have to be in any
  2253.                   specific File Area to perform a download.
  2254.  
  2255.                                                                         Page 40
  2256.         -----------------------------------------------------------------------
  2257.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2258.         -----------------------------------------------------------------------
  2259.         
  2260.  
  2261.         
  2262.           <U>.... Upload a File
  2263.                   This feature simply allows a user the opportunity to upload a
  2264.                   file.  The user can be compensated additional time on the
  2265.                   BBS for the upload.  The amount of the additional time is set
  2266.                   by the Sysop.  If the user has selected an automatic file
  2267.                   transfer protocol, then the user can manually select a
  2268.                   protocol by entering a semi-colon just before the file name.
  2269.         
  2270.                   EXAMPLE...
  2271.                   Enter name of file: ;SPITFIRE.ARC
  2272.         
  2273.           <H>.... Help on Upload/Download
  2274.                   This feature will describe the various file transfer
  2275.                   protocols available to the user.
  2276.         
  2277.           <P>.... Page the Sysop
  2278.                   This feature notifies the Sysop that a user has a question
  2279.                   or problem to visit about.
  2280.  
  2281.           <M>.... Message Section
  2282.                   This feature takes a user from the FILE section of SPITFIRE
  2283.                   to the MESSAGE section.
  2284.  
  2285.           <Q>.... Quit to Main Menu
  2286.                   This feature takes a user from the FILE section of SPITFIRE
  2287.                   to the MAIN section.
  2288.         
  2289.           <S>.... SPITFIRE Doors
  2290.                   This feature allows a caller to terminate SPITFIRE so a
  2291.                   third party program can be run online.  Normally, but not
  2292.                   always, the third party program is a game.  When finished
  2293.                   with the third party program, the caller is returned to
  2294.                   SPITFIRE.
  2295.  
  2296.           <N>.... New Files
  2297.                   This feature allows a user to search a specific File Area or
  2298.                   all File Areas for files available since a specific date or
  2299.                   since the last time the user searched for new files.
  2300.                   
  2301.           <T>.... Text Search
  2302.                   This feature allows a user to search for certain text within
  2303.                   a file description.  The user can search in a specific File
  2304.                   Area or in all File Areas.  Please note that this feature
  2305.                   searches ONLY the file's description and not the file's name,
  2306.                   date or size.  These will be displayed, however, when
  2307.                   matching text is located.
  2308.  
  2309.                                                                         Page 41
  2310.         -----------------------------------------------------------------------
  2311.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2312.         -----------------------------------------------------------------------
  2313.         
  2314.         
  2315.  
  2316.           <F>.... Find A File
  2317.                   This feature allows a user to search a specific File Area or
  2318.                   all File Areas for a certain file.  Wildcards are allowed.
  2319.                   If there is a match, the file name, size, date and
  2320.                   description will be shown, provided the file is listed in the
  2321.                   SFFILES.BBS.
  2322.         
  2323.           <X>.... Xpert Mode Toggle
  2324.                   This feature changes a user's status from a novice to an
  2325.                   expert or vice versa.  If a user is set as a novice, then
  2326.                   the menu descriptions will scroll by after each command.  If
  2327.                   a user is set as an expert, then only the command letters
  2328.                   scroll by after each command.
  2329.         
  2330.           <?>.... HELP with Commands
  2331.                   This feature will display help for each command available 
  2332.                   from the FILE MENU.  This feature is augmented with 
  2333.                   SFHELP.EXE, which creates separate help screens for each 
  2334.                   individual command.  For more information on SFHELP.EXE, 
  2335.                   consult the documentation accompanying it.  This program is 
  2336.                   available via download on Buffalo Creek's BBS in the 
  2337.                   "Spitfire & Spitfire Utilities" File Area.
  2338.  
  2339.           <@>.... Sysop Utilities
  2340.                   This feature takes a user from the FILE section to the SYSOP
  2341.                   section.  The BBS is maintained from the SYSOP section.  This
  2342.                   feature is not normally available to most users.
  2343.  
  2344.           <W>.... What's In An .ARC File
  2345.                   This feature allows a user to view the contents of an .ARC
  2346.                   file.  Presently the user will see the file name, file size
  2347.                   and file date of each file within the .ARC file.  The user
  2348.                   does not have to be in a specific File Area.
  2349.  
  2350.           <V>.... View A Text File
  2351.                   This feature allows a user to view a text file available for
  2352.                   download.  The user may want to use this feature and simply
  2353.                   capture the text to save downloading the file.  The user does
  2354.                   not have to be in a specific File Area to utilize this
  2355.                   feature.
  2356.                   
  2357.           <^D>... CTRL-D Macro
  2358.                   Executes the ^D macro a user has written.  This feature only
  2359.                   works if the user has written a macro.
  2360.         
  2361.           <^U>... CTRL-U Macro
  2362.                   Executes the ^U macro a user has written.  This feature only
  2363.                   works if the user has written a macro.
  2364.  
  2365.                                                                         Page 42
  2366.         -----------------------------------------------------------------------
  2367.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2368.         -----------------------------------------------------------------------
  2369.  
  2370.  
  2371.         11.2  UPLOAD/DOWNLOAD PROTOCOLS
  2372.         -------------------------------
  2373.         
  2374.              The following is a list of Upload & Download protocols available
  2375.         by SPITFIRE.
  2376.         
  2377.                                       1) Ascii
  2378.                                       2) Xmodem Checksum
  2379.                                       3) Xmodem CRC
  2380.          [* Presently D/L only]       4) 1K-Xmodem  [Ymodem]
  2381.                                       5) SEAlink Derived
  2382.                                 *     6) Ymodem Batch
  2383.                                 *     7) SEAlink Derived Batch
  2384.                                       8) Ymodem-g       [Error-checking modems]
  2385.                                 *     9) Ymodem-g Batch [Error-checking modems]
  2386.         
  2387.              It is planned to add batch uploads transfers a future release 
  2388.         of SPITFIRE. External Protocal file transfers are now available.  (For
  2389.         more information on the External Protocal feature see Section 17.0.)
  2390.  
  2391.              There seems to be mixed feeling regarding batch uploads on a BBS.
  2392.         Your input as a Sysop will be appreciated regarding this matter.  It
  2393.         may be that time should be spent adding other features rather than the
  2394.         batch upload transfers.
  2395.  
  2396.  
  2397.         12.0  SYSOP MENU EXPLAINED
  2398.         --------------------------
  2399.         
  2400.              Almost all the sysop utilities are contained in SPITFIRE.  No
  2401.         external programs are needed to do normal, day-to-day maintenance.
  2402.         However, it is our hope that people will implement utilities for
  2403.         SPITFIRE.  In the event you are interested in writing such a utility
  2404.         and need detailed information regarding how SPITFIRE interacts with
  2405.         different support files, please feel free to contact Buffalo
  2406.         Creek's BBS (515-225-8496).
  2407.         
  2408.         >>>>>>>> SPITFIRE SYSOP MENU <<<<<<<<
  2409.         <1>.... List event                 <2>.... Create event
  2410.         <3>.... Disable event              <4>.... Update system files
  2411.         <5>.... Modify users               <6>.... List Comments
  2412.         <7>.... List Callers Log           <8>.... Pack users file
  2413.         <9>.... Pack Message files         <A>.... Erase Alert File
  2414.         <B>.... Erase Callers file         <D>.... Drop to DOS
  2415.         <G>.... Goodbye & Log Off          <Q>.... Quit to MAIN MENU
  2416.         <L>.... List Sysop Alert File      <X>.... Xpert Mode Toggle
  2417.         <P>.... Print Users File
  2418.  
  2419.                                                                         Page 43
  2420.         -----------------------------------------------------------------------
  2421.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2422.         -----------------------------------------------------------------------
  2423.         
  2424.              
  2425.         
  2426.         12.1  SYSOP MENU EXPLANATION
  2427.         ----------------------------
  2428.         
  2429.              <1>....  List event
  2430.              -------------------
  2431.              SPITFIRE supports 13 scheduled events [A..M].  When you select
  2432.              this feature, you will be asked which event [A..M] you wish to 
  2433.              view.  If the event you select is not configured, SPITFIRE will 
  2434.              state that this event is not activated.  If the event you select 
  2435.              is configured, then SPITFIRE will display the time of the event,
  2436.              the day of the event, whether the event is active and whether it 
  2437.              has been completed that day.
  2438.  
  2439.              <2>....  Create event
  2440.              ---------------------
  2441.              This feature is used to create one of the 13 scheduled events
  2442.              available.  When you select this feature, you will be asked 
  2443.              which event you wish to create.  If you select one that is 
  2444.              already active, SPITFIRE will notify you that the event selected 
  2445.              is already active and then ask you if you wish to change it.  If
  2446.              the requested event designation is not active, you will then be
  2447.              asked for the time of the event (use military time.  Ex: 22:00 = 
  2448.              10pm).  Next you will be asked which day for the event.  The 
  2449.              format looks like this:
  2450.              0=Sunday, 1=Monday, 2=Tuesday, etc....7=All!
  2451.         
  2452.              After selecting the desired scheduled event and designating the
  2453.              time and day the event is to be performed, you will need to
  2454.              modify the SF.BAT file with your favorite text editor.  For 
  2455.              illustration purposes, let's assume you wish to execute Buffalo
  2456.              Creek Software's SFDNLDS.EXE to create a listing of the weekly
  2457.              download activity on your BBS.  SFDNLDS.EXE uses the switch /F to
  2458.              specify the filename that will be created with the information.
  2459.              Our example will use the file BULLET1.BBS so the users may view
  2460.              the file from the <B>.... Bulletin option of the Main Menu.  To 
  2461.              simplify explanation, we will also assume all files are being run 
  2462.              from the SF directory, rather than individual file paths and the 
  2463.              event you wish to create will be event A.
  2464.              
  2465.              First, you will need to select <2>.... Create event from the Sysop
  2466.              utilities menu and then choose A as the event to be created.  You
  2467.              are then prompted for the time the event will be performed.  Let's
  2468.              assume you will enter 01:00.  Next, you are prompted for the day
  2469.              the event will be performed.  Let's assume you wish to run the 
  2470.              event every Sunday so enter 0.
  2471.  
  2472.                                                                         Page 44
  2473.         -----------------------------------------------------------------------
  2474.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2475.         -----------------------------------------------------------------------
  2476.         
  2477.  
  2478.         
  2479.              
  2480.              Now, using your favorite text editor, the SF.BAT file for Event A 
  2481.              will look like this:
  2482.              
  2483.              :EVENT_A
  2484.              REM Place Event Commands Here
  2485.              GOTO LOOP
  2486.              
  2487.              What is required next is to include all necessary DOS commands
  2488.              which are needed to run the SFDNLDS.EXE program and enter those
  2489.              in place of the "REM Place Event Commands Here".  A completed
  2490.              SF.BAT for Event A would appear as:
  2491.              
  2492.              :EVENT_A
  2493.              SFDNLDS /F BULLET1.BBS             
  2494.              GOTO LOOP
  2495.  
  2496.              With this event set up in the previously described manner, every
  2497.              Sunday morning at 1:00 am, SFDNLDS would create a listing of the
  2498.              BBS weekly downloads and save the information in the BULLET1.BBS
  2499.              file.
  2500.  
  2501.              IMPORTANT NOTE REGARDING SCHEDULED EVENTS!
  2502.              ------------------------------------------
  2503.              Unique to most other Bulletin Board Systems, if a user is online
  2504.              when an event is scheduled to occur, SPITFIRE waits until the user
  2505.              logs off and then performs the scheduled event.  In this fashion,
  2506.              the user is not interrupted or subject to a forced log-off.
  2507.              Please note the Event M is already configured to Pack Message 
  2508.              Base.  At the scheduled time you designate, SPITFIRE initiates 
  2509.              Event M to Pack The Message Base by erasing all messages marked 
  2510.              for deletion and creates backup files (refer to Section 3.6).  
  2511.              This should be done routinely to conserve disk space.
  2512.         
  2513.              <3>....  Disable event
  2514.              ----------------------
  2515.              This feature is used to disable an event that you have configured.
  2516.              If the event is active, SPITFIRE will ask you if you are certain 
  2517.              you want to disable it. In the event you answer "Yes", it will be
  2518.              disabled.
  2519.         
  2520.              <4>....  Update System Files
  2521.              ----------------------------
  2522.              Selecting this feature performs the same functions as selecting
  2523.              ALT+R at the "Ready..." prompt.  Refer to Section 5.0 for more 
  2524.              details.
  2525.  
  2526.                                                                         Page 45
  2527.         -----------------------------------------------------------------------
  2528.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2529.         -----------------------------------------------------------------------
  2530.         
  2531.  
  2532.         
  2533.              <5>....  Modify users
  2534.              ---------------------
  2535.              This feature is the same as selecting ALT+A at the "Ready..."
  2536.              prompt.  The menu that accompanies this selection is pretty much
  2537.              self-explanatory.  This feature is used to change statistics on 
  2538.              any user.
  2539.  
  2540.              <6>....  List Comments
  2541.              ----------------------
  2542.              This feature searches all Message Areas for messages addressed 
  2543.              to you.  If any messages are found, then SPITFIRE shows them to
  2544.              you.  If there are no messages found, then SPITFIRE notifies you
  2545.              that there are no messages addressed to you.
  2546.  
  2547.              <7>....  List Callers Log
  2548.              -------------------------
  2549.              When a user is online, SPITFIRE records the activities of the
  2550.              user in a text file named "CALLERS.LOG".  By selecting this 
  2551.              feature, SPITFIRE will scroll the contents of the CALLERS.LOG 
  2552.              file to the monitor.
  2553.         
  2554.              <8>....  Pack Users File
  2555.              ------------------------
  2556.              This feature allows you to pack SFUSERS.DAT.  When using this
  2557.              feature, SPITFIRE will purge any user marked for deletion from the
  2558.              user's file.  Also, SPITFIRE gives you the opportunity to purge
  2559.              inactive users.  When you select this feature, SPITFIRE will ask 
  2560.              if you wish to purge inactive users.  If you answer "Y", then you 
  2561.              will be asked to purge users that haven't called for [x] amount 
  2562.              of days.  The value of [x] is determined by you.  Those users 
  2563.              who haven't logged on for [x] amount of days will then be purged 
  2564.              from the user's file.
  2565.              
  2566.              <9>....  Pack Message Base
  2567.              --------------------------
  2568.              When you select this feature, you will be asked if you're sure you
  2569.              want to pack the message base.  If you answer "y", SPITFIRE goes
  2570.              through the message files and purges all messages that have been 
  2571.              marked as deleted.  SPITFIRE also provides the option of packing 
  2572.              messages posted prior to a specified date which you are prompted 
  2573.              to enter.  SPITFIRE prompts you if you would like to purge old 
  2574.              messages.  If you reply "Y" to the prompt inquiring, you are then
  2575.              asked to purge messages that are [x] days old.  The value of [x] 
  2576.              is determined by you.  Any messages [x] days old will then be 
  2577.              purged from the message base.  It is recommended that you do this
  2578.              on a regular basis for a couple of reasons: [1]  Disk space.  
  2579.              [2] Speed (SPITFIRE works faster with fewer messages).
  2580.  
  2581.                                                                         Page 46
  2582.         -----------------------------------------------------------------------
  2583.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2584.         -----------------------------------------------------------------------
  2585.         
  2586.  
  2587.         
  2588.              <A>....  Erase Alert File
  2589.              --------------------------
  2590.              SPITFIRE creates and writes to a text file named "HEYSYSOP.LOG".
  2591.              The contents of this file are to notify you of problems or special
  2592.              features that a user may utilize, such as a file transfer 
  2593.              uploaded for Sysop Only.  This feature gives you the opportunity 
  2594.              to erase "HEYSYSOP.LOG".
  2595.  
  2596.              <B>....  Erase Callers File
  2597.              ----------------------------
  2598.              This feature gives you the opportunity to erase the CALLERS.LOG
  2599.              which was described previously.  You may want to keep a permanent 
  2600.              record of your user's activities which are contained in this file.
  2601.              In this case, you wouldn't want to delete the file, but rather 
  2602.              copy it to a floppy for record purposes.  You will need to do 
  2603.              this if you are interested in conserving disk space.
  2604.  
  2605.              <D>...  Drop to DOS
  2606.              -------------------
  2607.              This feature allows you to drop to DOS from a remote location.
  2608.              You need to use the ALT+J feature to drop to DOS locally.  When 
  2609.              this feature is used from a remote location, SPITFIRE will not 
  2610.              allow the user to drop to DOS unless the drop-to-DOS password is 
  2611.              properly entered.  This password is configured using the ALT+Z 
  2612.              command at the "Ready..." prompt.  It is recommended that this 
  2613.              feature be made available to only trusted users, if made 
  2614.              available at all.  When this feature is utilized, SPITFIRE shells
  2615.              to SFREMOTE.BAT.
  2616.         
  2617.              <G>....  Goodbye & Log Off
  2618.              --------------------------
  2619.              This feature simply allows you to log off the BBS.
  2620.              
  2621.              <Q>....  Quit to MAIN MENU
  2622.              --------------------------
  2623.              This feature takes you from the Sysop Utility Section of SPITFIRE
  2624.              to the MAIN MENU.
  2625.  
  2626.              <L>....  List Sysop Alert File
  2627.              ------------------------------
  2628.              SPITFIRE creates and writes to a textfile named "HEYSYSOP.LOG".
  2629.              The contents of this file are to notify you of problems or special
  2630.              features that a user may utilize, such as a file transfer 
  2631.              uploaded for Sysop Only.  When this feature is selected, SPITFIRE
  2632.              will display the contents of HEYSYSOP.LOG to the monitor.
  2633.  
  2634.                                                                         Page 47
  2635.         -----------------------------------------------------------------------
  2636.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2637.         -----------------------------------------------------------------------
  2638.  
  2639.         
  2640.              <X>.... Xpert Mode Toggle
  2641.              -------------------------
  2642.              This feature changes your status from a novice to an expert or
  2643.              vice versa.  If you are set as a novice, then the menu 
  2644.              descriptions will scroll by after each command.  If you are set 
  2645.              as an expert, then only the command letters scroll by after each 
  2646.              command.
  2647.         
  2648.              <P>....  Print Users File
  2649.              -------------------------
  2650.              This feature prints out a hardcopy list of users' names, their
  2651.              cities and phone numbers.  This can only be executed locally.
  2652.  
  2653.  
  2654.         13.0  SPECIAL COMMANDS FOR SYSOP STATUS
  2655.         ---------------------------------------
  2656.         
  2657.              Definition of Sysop Status
  2658.              --------------------------
  2659.              When we refer to Sysop Status in this manual, we refer to any user
  2660.         that has a security level equal to, or greater than, the Sysop security
  2661.         level set using the ALT+Z feature at the "Ready..." prompt.
  2662.         
  2663.              The Message section has a few "Special Commands" for sysop
  2664.         privileged users.
  2665.         
  2666.              It's important to note that only the sender and receiver can
  2667.         delete messages, except for users with sysop security privileges, who
  2668.         can read, delete, un-delete and move any message.
  2669.         
  2670.              The <M>ove command is present so that Sysops can move a message
  2671.         from one area to another.
  2672.         
  2673.              The <P>rivate command is a toggle that can be used to make a
  2674.         private message public and a public message private.
  2675.         
  2676.              Last in the message arena is the <U>ndelete command.  Anyone with
  2677.         sysop privileges will automatically be able to read all the messages in
  2678.         the message system, even if they have been deleted.  If you see a
  2679.         message which has been marked for deletion you may UN-DELETE it by
  2680.         using this command.  Your callers will not be able to read deleted
  2681.         messages unless their access level is considered sysop level.
  2682.         
  2683.              In the arena of file transfers, if a user with Sysop security
  2684.         attempts to upload a file that already exists, then that user is given
  2685.         the opportunity to overwrite the file.  The user will be warned that
  2686.         said file already exists and given the option to overwrite it.
  2687.         SPITFIRE will not allow any other user without Sysop security this
  2688.         privilege.
  2689.  
  2690.                                                                         Page 48
  2691.         -----------------------------------------------------------------------
  2692.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2693.         -----------------------------------------------------------------------
  2694.         
  2695.         
  2696.         14.0 HARDWARE/SOFTWARE DATA FLOW CONTROL
  2697.         ----------------------------------------
  2698.         
  2699.              When you select ALT+M to configure your modem, you will notice
  2700.         a Hardware Data Flow Control switch.  This switch is turned on 
  2701.         (Yes) when you are using a modem that automatically adjusts to the
  2702.         baud rate of the incoming call rather than depending on the software
  2703.         to reset the baud rate of the comm port.  If the switch is set to
  2704.         Yes, then SPITFIRE will not adjust the comm port to the baud rate of
  2705.         the incoming call.  If the switch is set to No, then SPITFIRE will
  2706.         adjust the comm port to the baud rate of the incoming call.  One 
  2707.         case of having this switch set to YES is when you are using a USR
  2708.         HST modem at 19200 baud.  In this case you need to use the modem
  2709.         initilization string mentioned earlier in this manual.  If you are
  2710.         not sure if your modem adjusts to the baud rate of the incoming call,
  2711.         refer to your modem manual.
  2712.  
  2713.  
  2714.         15.0  SCREEN SAVE FEATURE
  2715.         -------------------------
  2716.         
  2717.              SPITFIRE contains its own Screen Save Feature to prevent
  2718.         screen-burn.  If you are presently using a memory-resident screen-save
  2719.         utility, it is recommended that you discontinue its usage in favor of
  2720.         this feature.
  2721.  
  2722.  
  2723.         16.0 SPITFIRE DOORS FEATURE
  2724.         ---------------------------
  2725.         
  2726.              This feature is designed to allow the use of third party
  2727.         programs (normally referred to as door programs) which are not part
  2728.         of SPITFIRE but are provided by sources other than Buffalo Creek
  2729.         Software.  There are no door programs distributed with SPITFIRE
  2730.         because these are usually Shareware products and Buffalo Creek
  2731.         Software very likely has no right to distribute them with the 
  2732.         SPITFIRE program.  However, there are many available for download
  2733.         from Buffalo Creek's BBS as well as most other bulletin boards.  In
  2734.         the event you do not wish to run third party programs with SPITFIRE
  2735.         through the Door feature, simply set the security level of the
  2736.         SPITFIRE Door command in the SFMAIN.MNU, SFFILE.MNU and SFMSG.MNU files
  2737.         high enough so your users cannot access it.
  2738.         
  2739.              SPITFIRE Doors can be accessed by a caller from the Main Menu,
  2740.         File Menu and Message Menu, provided the caller's security level is
  2741.         high enough.  SPITFIRE supports the use of 8 different doors.  However,
  2742.         there are third party programs that can turn these 8 doors into
  2743.         hundreds of doors.  One example of such a program is WILDFIRE, which
  2744.  
  2745.                                                                         Page 49
  2746.         -----------------------------------------------------------------------
  2747.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2748.         -----------------------------------------------------------------------
  2749.         
  2750.         
  2751.         
  2752.         is Shareware from Steve Cox.  The newest release of WILDFIRE can be
  2753.         downloaded from Buffalo Creek's BBS and Flite-Line BBS (402) 421-2434.
  2754.         
  2755.              Let's configure your first door now, step by step.  The first
  2756.         thing to do is create a file named SFDOOR.MNU, using your favorite
  2757.         text editor.  Place it in your system files directory.  Keep in mind 
  2758.         SPITFIRE only supports 8 doors so your SFDOOR.MNU file can have a
  2759.         maximum of 8 lines.  Since we are configuring door #1, SFDOOR.MNU will
  2760.         have only 1 line.  For demonstration purposes, let's write the line to
  2761.         look like this:
  2762.  
  2763.         Demo Door,10
  2764.         
  2765.              The name of the door (as you'll have it appear in the Door Menu)
  2766.         comes first in the line.  You then enter a comma, which is used to
  2767.         tell SPITFIRE where to end the name of the door and where to start
  2768.         reading the security level of the door.  In the above example, the name
  2769.         of the door is "Demo Door" and it requires a security level of 10 for a
  2770.         caller to be able to use it.
  2771.         
  2772.              Now load your SF.BAT file into your favorite text editor and find
  2773.         a line that reads :DOOR_1.  You will place your door #1 commands (valid
  2774.         DOS commands, program execution, etc.) between :DOOR_1 and GOTO LOOP.
  2775.         For demonstration purposes, simply add a line that reads PAUSE between
  2776.         :DOOR_1 and GOTO LOOP.  That portion of your SF.BAT file should now
  2777.         read as listed below:
  2778.         
  2779.         :DOOR_1
  2780.         PAUSE
  2781.         GOTO LOOP
  2782.         :DOOR_2
  2783.                                                             
  2784.  
  2785.              Once you have saved the changes in your SF.BAT file to disk, then
  2786.         boot SPITFIRE using your SF.BAT file.  At the "SPITFIRE ready for..."
  2787.         prompt, log on locally either using the ALT+S or ALT+Q keystrokes.
  2788.         When you get to the Main Menu, select "<S>... SPITFIRE Doors" and your
  2789.         Door Menu should appear something like this:
  2790.         
  2791.         >>>>>>>> SPITFIRE DOOR MENU <<<<<<<<
  2792.         <1>... Demo Door                     <2>... Unavailable to you
  2793.         <3>... Unavailable to you            <4>... Unavailable to you     
  2794.         <5>... Unavailable to you            <6>... Unavailable to you     
  2795.         <7>... Unavailable to you            <8>... Unavailable to you     
  2796.         <Q>... Quit                          <G>... Goodbye
  2797.         
  2798.         DOOR MENU - [1 2 3 4 5 6 7 8 Q G]?
  2799.  
  2800.                                                                         Page 50
  2801.         -----------------------------------------------------------------------
  2802.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2803.         -----------------------------------------------------------------------
  2804.  
  2805.  
  2806.  
  2807.         
  2808.              If you select <1> at this point, you will see a message 
  2809.         SPITFIRE displays that states "Executing SPITFIRE Door 1...  Please
  2810.         stand by!".  At this point, SPITFIRE writes a read-only text file to
  2811.         drive named SFDOORS.DAT and then terminates, sending the appropriate
  2812.         ERROR CODE to your SF.BAT file.  In the case of door #1, SPITFIRE sends
  2813.         an ERROR CODE of 34 to SF.BAT which will cause the command(s) you have
  2814.         placed between :DOOR_1 and GOTO LOOP to be executed.  In the event you
  2815.         entered a PAUSE command between :DOOR_1 and GOTO LOOP, you will then
  2816.         get a "Strike a key when ready. . ." message.  When you strike a key,
  2817.         you will see SPITFIRE reboot and you will be prompted for your
  2818.         password.
  2819.  
  2820.              If a caller enters a door while logged on SPITFIRE, there are
  2821.         three tests that must be passed for the caller to return to SPITFIRE
  2822.         after exiting the door program.  First, SPITFIRE must find
  2823.         SFDOORS.DAT in the system files directory.  Second, SPITFIRE must
  2824.         find that a carrier detect exists.  And third, the caller must enter
  2825.         the correct password when prompted for it.  In the event a door is
  2826.         entered during a local log on, there are two tests that must be
  2827.         passed.... SPITFIRE must find the SFDOORS.DAT file and the correct 
  2828.         password must be entered.
  2829.  
  2830.  
  2831.         16.1 SPITFIRE DOORS DISPLAY FILES
  2832.         ---------------------------------
  2833.  
  2834.              SPITFIRE will use certain display files during the use of the
  2835.         Doors feature, if such files are found.  It is important to note
  2836.         that SPITFIRE will work just fine without these display files.
  2837.         If SPITFIRE finds SFDR[x].BBS/.CLR (the [x] stands for the caller's
  2838.         security level--for example, SFDR10.BBS would be displayed to a caller
  2839.         with a security level of 10), this file is displayed instead of
  2840.         SPITFIRE automatically building the Door Menu shown above. If
  2841.         SPITFIRE finds SFDOOR[x].BBS/.CLR (the [x] stands for the number
  2842.         about to be entered--for example, SFDOOR1.BBS would be shown when a 
  2843.         caller enters SPITFIRE Door #1), it will be displayed just before 
  2844.         SPITFIRE terminates for the door program execution.  This file might
  2845.         be used to send the caller a special message about the door.  When
  2846.         the caller quits the door program and returns to SPITFIRE, a file named
  2847.         SFDORBAK.BBS/.CLR is displayed, if found.  This file is normally used
  2848.         simply to welcome the caller back to SPITFIRE.
  2849.  
  2850.                                                                         Page 51
  2851.         -----------------------------------------------------------------------
  2852.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2853.         -----------------------------------------------------------------------
  2854.         
  2855.         
  2856.         
  2857.         16.2 SPITFIRE DOORS SUPPORT
  2858.         ----------------------------
  2859.  
  2860.              Configuring the use of doors with SPITFIRE will be supported by
  2861.         Buffalo Creek Software for registered users of SPITFIRE.  However,
  2862.         should you have problems with the door program itself, please read the
  2863.         documentation and then contact the author of the program.  Please keep
  2864.         in mind that once a caller has entered a door, SPITFIRE is completely
  2865.         out of memory and has NO responsibility for the operation of the door
  2866.         program.
  2867.  
  2868.  
  2869.         17.0 EXTERNAL FILE TRANSFER PROTOCOLS
  2870.         -------------------------------------
  2871.         
  2872.              This feature is designed to allow the use of file transfer
  2873.         protocols which are not part of SPITFIRE but are rather provided
  2874.         by sources other than Buffalo Creek Software.  An example is ZModem,
  2875.         a popular protocol written by Chuck Foresburg.  There are no External
  2876.         Protocols distributed with SPITFIRE because they are usually
  2877.         Shareware products.  Buffalo Creek Software most likely has no right
  2878.         to distribute them with the SPITFIRE program.  However, there are
  2879.         many available for download from Buffalo Creek's BBS as well as most
  2880.         other bulletin boards.
  2881.         
  2882.              It should be noted that SPITFIRE does not allow users
  2883.         to select an external protocol as their default file transfer 
  2884.         protocol.  This is important for users to know, so SPITFIRE
  2885.         has provided a means to specify it:
  2886.  
  2887.              When a new user logs on or when callers use the "<Y>... Your
  2888.         Statistics" from the Main Menu to change their default file transfer
  2889.         protocol, SPITFIRE will display SFPROMSG.BBS/.CLR just before a 
  2890.         default file transfer protocol seletion is made. The SFPROMSG.BBS/.CLR
  2891.         message can state if a default file transfer protocol is chosen, the
  2892.         external protocol option will not will not be available.  Callers
  2893.         wishing to utilize external protocols should set their default to none.
  2894.         
  2895.  
  2896.         17.1 EXTERNAL DOWNLOAD PROTOCOLS
  2897.         --------------------------------
  2898.         
  2899.              SPITFIRE allows up to 9 external protocols [A..I] to be utilized
  2900.         for downloads.  It may be best at this point to go thru setting up
  2901.         a download external protocol, step by step.  
  2902.  
  2903.                                                                         Page 52
  2904.         -----------------------------------------------------------------------
  2905.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2906.         -----------------------------------------------------------------------
  2907.  
  2908.  
  2909.  
  2910.              To start, an assumption is being made that you have a copy of
  2911.         DSZ.COM (Foresburg's ZModem).  If you do not have a copy, you can 
  2912.         download it from Buffalo Creek's BBS.  You will need to use your
  2913.         favorite text editor to create a display file named SFEXTDN.BBS.
  2914.         This is a simple text file which will contain the names of the
  2915.         external protocols you will have available and does nothing more 
  2916.         than list them.
  2917.  
  2918.              For the purpose of setting up ZModem as your first download
  2919.         external protocol, your SFEXTDN.BBS file would have one line that
  2920.         would look something like this:
  2921.         
  2922.         <A> ZModem
  2923.  
  2924.              Now place SFEXTDN.BBS in the directory you have configured as
  2925.         your Display Files Path.  Next, boot SPITFIRE.  At the "SPITFIRE 
  2926.         ready for caller" prompt, simultaneously press your ALT+P keys.  The
  2927.         SPITFIRE FILE PATHS window will open and you need to select <4> to
  2928.         set your External Transfer Path.  An assumption (for demonstration
  2929.         purposes) is being made here that you are running SPITFIRE on your C
  2930.         drive in a directory named SF.  At this point, set your External
  2931.         Transfer Path to C:\SF\EXTERNAL.  If a valid path has been entered,
  2932.         SPITFIRE will create the directory--if one does not already exist.  If
  2933.         the External Transfer Protocols switch is set to "No", then toggle it
  2934.         to "Yes" by selecting <1>.  Now, select <Q> to Quit to the "SPITFIRE
  2935.         ready for caller" prompt and then select F10 to exit SPITFIRE.
  2936.         
  2937.              The next step is to place DSZ.COM in the directory you set as
  2938.         your External Transfer Path (example... C:\SF\EXTERNAL).  Next, using
  2939.         your favorite text editor, create a batch file named SFEXTDNA.BAT
  2940.         in the directory designated as your External Transfer Path.  SPITFIRE
  2941.         shells to this batch when a caller selects <A>... from the download
  2942.         protocol list.  It is appropriate at this point to show the suggested
  2943.         contents of this batch file.
  2944.         
  2945.         Echo Off
  2946.         BRK OFF
  2947.         Echo Executing SPITFIRE'S External Protocol #1
  2948.         CD\SF\EXTERNAL
  2949.         DSZ.COM %2 sz %3
  2950.         ERASE %3
  2951.         CD\SF
  2952.         BRK ON
  2953.  
  2954.              Now that SFEXTDNA.BAT, with the above listed commands, resides
  2955.         in the directory you set as your External Transfer Path, you have 
  2956.         configured your first download External Protocol.  The actual contents
  2957.  
  2958.                                                                         Page 53
  2959.         -----------------------------------------------------------------------
  2960.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  2961.         -----------------------------------------------------------------------
  2962.         
  2963.         
  2964.  
  2965.         of the batch files you will use will depend on the specific protocols.
  2966.         The above is only a sample batch file that should work fine with
  2967.         DSZ.COM.
  2968.         
  2969.              Before the commands in the above described batch file are
  2970.         explained, it is important to note when a caller selects <B>...
  2971.         from the download protocol list, then SPITFIRE shells to a batch file
  2972.         named SFEXTDNB.BAT.  As stated before, there are nine external
  2973.         protocols allowed and are denoted by command letters "A" thru "I".
  2974.         These command letters are used to shell SPITFIRE to the corresponding
  2975.         batch files.
  2976.         
  2977.         A = SFEXTDNA.BAT          B = SFEXTDNB.BAT         C = SFEXTDNC.BAT
  2978.         D = SFEXTDND.BAT          E = SFEXTDNE.BAT         F = SFEXTDNF.BAT
  2979.         G = SFEXTDNG.BAT          H = SFEXTDNH.BAT         I = SFEXTDNI.BAT
  2980.  
  2981.              Now, an explanation of these batch files and what SPITFIRE does
  2982.         in preparation to use these batch files is appropriate and important
  2983.         for you to know and understand.
  2984.  
  2985.              When an External Protocol is selected, SPITFIRE does all the
  2986.         normal tests to be sure it is permissible for the caller to perform
  2987.         the download.  If allowable, then SPITFIRE copies the selected file
  2988.         to the directory you have configured as your External Transfer Path.  
  2989.         PLEASE NOTE THAT SPITFIRE COPIES THE SELECTED FILE.  THIS MEANS THERE
  2990.         MUST BE ENOUGH DISK SPACE AVAILABLE FOR THE FILE TO BE COPIED.  Now, 
  2991.         if all tests were passed and the file was successfully copied, then
  2992.         SPITFIRE switches to the directory you have configured as your External
  2993.         Transfer Path and stays in memory but shells to the appropriate batch
  2994.         file (as described above).  Keep in mind that SPITFIRE is resident in
  2995.         memory, as well as a second copy of the command processor (COMMAND.COM)
  2996.         so the external file transfer protocol is going to require some memory.
  2997.  
  2998.              Upon performing this shell, SPITFIRE is passing at least three
  2999.         parameters to the appropriate batch file.  The first parameter is the
  3000.         baud rate.  The second parameter being passed is the number of the 
  3001.         comm port being used.  The third parameter is the name of the file to
  3002.         be downloaded. This passed information is needed by most external file
  3003.         transfer programs and can now be used with DOS batch commands.  The
  3004.         filename is passed in ASCII text as %3. The baud rate is %1, a number
  3005.         representing baud rate of the caller, such as 2400.  The comm port %2
  3006.         is the number of the comm port being used (1,2,3 or 4).  In the event
  3007.         you're are not familiar with the use of the % command in batch files,
  3008.         refer to your DOS manual for specific details.
  3009.  
  3010.                                                                         Page 54
  3011.         -----------------------------------------------------------------------
  3012.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3013.         -----------------------------------------------------------------------
  3014.         
  3015.         
  3016.         
  3017.              When the external protocol file transfer program has finished
  3018.         its work, control is automatically returned to SPITFIRE.  Once control
  3019.         is returned, then SPITFIRE switches back to the directory in which the
  3020.         SPITFIRE system files reside.  SPITFIRE then erases the file that was
  3021.         copied to the directory you have configured as your External Transfer
  3022.         Path for download.  Last, SPITFIRE checks the amount of time that
  3023.         passed during the shell to the external protocol batch file.  In the
  3024.         event SPITFIRE discovers that the time spent in the shell was at least
  3025.         30% of the estimated transfer time, then the number of downloads, 
  3026.         K downloaded, etc. of the caller is updated.  In the event the time
  3027.         spent in the shell was less than 30% of the estimated transfer time,
  3028.         then SPITFIRE assumes that the transfer was not successful and the
  3029.         callers data is not updated.
  3030.                 
  3031.              You will notice the example batch file (above) has a command
  3032.         to change to the directory you have configured as your External
  3033.         Transfer Path.  You will also notice there is a another command to
  3034.         change back to the SPITFIRE system files directory.  Further, you will
  3035.         notice there is a command to erase the file that was copied to
  3036.         the directory for download.  These commands do not have to be in the
  3037.         batch files you create because SPITFIRE automatically performs these
  3038.         chores.  However, it is quite permissible for the commands to be in
  3039.         the batch file and they can act as a safeguard.  You will also notice a
  3040.         command BRK OFF at the beginning of the batch file example, as well as
  3041.         a BRK ON at the end.  BRK is a Shareware utility distributed by Solid
  3042.         Systems of Newport News, Virginia.  It is used to disable and enable
  3043.         the CTRL BREAK, which can be used to terminate a batch file.  You will
  3044.         need this utility for the protection of your system.  BRK.ARC can be
  3045.         downloaded from Buffalo Creek's BBS.
  3046.                 
  3047.  
  3048.         17.2 EXTERNAL UPLOAD PROTOCOLS
  3049.         ------------------------------
  3050.  
  3051.              SPITFIRE allows up to 9 external protocols [A..I] to be utilized
  3052.         for uploads.  Since SPITFIRE handles external protocols for uploading
  3053.         slightly different than downloading, it may be best at this point to
  3054.         go thru setting up an upload external protocol, step by step.  To
  3055.         start, an assumption is being made you have a copy of DSZ.COM
  3056.         (Foresburg's ZModem).  If you do not have a copy, you can download it
  3057.         from Buffalo Creek's BBS.  Now, you will need to use your favorite
  3058.         text editor and create a display file named SFEXTUP.BBS, a simple text
  3059.         file which will contain the names of the external protocols you will
  3060.         have available and does nothing more than list the available protocols.
  3061.         For the purpose of setting up ZModem as your first upload external
  3062.         protocol, your SFEXTUP.BBS file would have one line that would look
  3063.         something like this:
  3064.  
  3065.                                                                         Page 55
  3066.         -----------------------------------------------------------------------
  3067.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3068.         -----------------------------------------------------------------------
  3069.         
  3070.  
  3071.         
  3072.         <A> ZModem
  3073.         
  3074.              Now place SFEXTUP.BBS in the directory you have configured as
  3075.         your Display Files Path.  Next, boot SPITFIRE.  At the "SPITFIRE 
  3076.         ready for caller" prompt, simultaneously press your ALT+P keys.  The
  3077.         SPITFIRE FILE PATHS window will open and you need to select <4> to
  3078.         set your External Transfer Path.  An assumption (for demonstration
  3079.         purposes) is being made here that you are running SPITFIRE on your C
  3080.         drive in a directory named SF.  At this point, set your External
  3081.         Transfer Path to C:\SF\EXTERNAL.  If a valid path has been entered,
  3082.         SPITFIRE will create the directory if one does not already exist.  If
  3083.         the External Tranfer Protocols switch is set to "No", then toggle it
  3084.         to "Yes" by selecting <1>.  Now, select <Q> to Quit to the "SPITFIRE
  3085.         ready for caller" prompt and then select F10 to exit SPITFIRE.
  3086.  
  3087.              The next step is to place DSZ.COM in the directory you set as
  3088.         your External Transfer Path (example... C:\SF\EXTERNAL).  Next, using
  3089.         your favorite text editor, create a batch file named SFEXTUPA.BAT
  3090.         in the directory designated as your External Transfer Path.  SPITFIRE
  3091.         shells to this batch file when a caller selects <A>... from the upload
  3092.         protocol list.  It is appropriate at this point to show the suggested
  3093.         contents of this batch file.
  3094.         
  3095.         Echo Off
  3096.         BRK OFF
  3097.         Echo Executing External Protocol #1
  3098.         CD\SF\EXTERNAL
  3099.         DSZ.COM %2 rz
  3100.         MUV %3 %4
  3101.         CD\SF
  3102.         BRK ON
  3103.  
  3104.              Now that SFEXTUPA.BAT, with the above listed commands, resides
  3105.         in the directory you set as your External Transfer Path, you have 
  3106.         configured your first upload External Protocol.  The actual contents
  3107.         of the batch files you will use will depend on the specific protocols.
  3108.         The above is only a sample batch file and should work fine with
  3109.         DSZ.COM.
  3110.         
  3111.              Before the commands in the above described batch file are
  3112.         explained, it is important to note when a caller selects <B>... from
  3113.         the upload protocol list, then SPITFIRE shells to a batch file named
  3114.         SFEXTUPB.BAT.  As stated before, there are nine external protocols
  3115.         allowed and are denoted by command letters "A" thru "I".  Through
  3116.         their use, SPITFIRE shells to the corresponding batch files.
  3117.  
  3118.                                                                         Page 56
  3119.         -----------------------------------------------------------------------
  3120.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3121.         -----------------------------------------------------------------------
  3122.         
  3123.  
  3124.         
  3125.         A = SFEXTUPA.BAT          B = SFEXTUPB.BAT         C = SFEXTUPC.BAT
  3126.         D = SFEXTUPD.BAT          E = SFEXTUPE.BAT         F = SFEXTUPF.BAT
  3127.         G = SFEXTUPG.BAT          H = SFEXTUPH.BAT         I = SFEXTUPI.BAT
  3128.  
  3129.              Now, an explanation of these batch files and what SPITFIRE does
  3130.         in preparation to use them is appropriate and important for you to
  3131.         know and understand.
  3132.         
  3133.              When an External Protocol is selected, SPITFIRE does all the
  3134.         normal tests to be sure it is permissible for the caller to perform
  3135.         the upload.  If all tests were passed, then SPITFIRE changes to the
  3136.         directory you have configured as your External Transfer Path and stays
  3137.         resident in memory but shells to the appropriate batch file (as
  3138.         described above).  Keep in mind that SPITFIRE is resident in memory,
  3139.         as well as a second copy of the command processor (COMMAND.COM), so the
  3140.         external file transfer protocol is going to require some memory.
  3141.         
  3142.              Upon performing this shell, SPITFIRE is passing four parameters
  3143.         to the appropriate batch file.  The first parameter is the baud rate.
  3144.         The second parameter being passed is the number of the comm port being 
  3145.         used.  The third parameter is the name of the file to be uploaded. The
  3146.         fourth parameter is the path in which the file to be uploaded is to 
  3147.         reside (i.e. - C:\SF\UPLOADS).  This passed information is needed by 
  3148.         most external file transfer programs and can now be used with DOS batch
  3149.         commands.  The filename is passed in ASCII text as %3. The baud rate is
  3150.         %1, a number representing baud rate of the caller, such as 2400.  The
  3151.         comm port %2 is the number of the comm port being used (1,2,3 or 4).
  3152.         In the event you're are not familiar with the use of the % command in
  3153.         batch files, refer to your DOS manual for specific details.
  3154.         
  3155.              When the external protocol file transfer program has finished
  3156.         its work, control is automatically returned to SPITFIRE.  Once control
  3157.         is returned, then SPITFIRE changes back to the directory in which the
  3158.         SPITFIRE system files reside.  SPITFIRE now checks to see if the file
  3159.         that was to be uploaded exists in File Area in which the uploaded file
  3160.         should reside if all went correctly.  If SPITFIRE finds the file in 
  3161.         the appropriate File Area, the caller is then credited with the upload
  3162.         and other clean up chores are performed.  In the event SPITFIRE does 
  3163.         not find the file in the appropriate File Area, then SPITFIRE assumes 
  3164.         the upload was aborted.
  3165.                 
  3166.              You will notice that the example batch file (above) has a command
  3167.         to change to the directory you have configured as your External
  3168.         Transfer Path.  You will also notice there is a another command to
  3169.         change back to the SPITFIRE system files directory.  These commands do
  3170.         not have to be in the batch files you create because SPITFIRE
  3171.         automatically performs these chores.  However, it is quite permissible
  3172.  
  3173.                                                                         Page 57
  3174.         -----------------------------------------------------------------------
  3175.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3176.         -----------------------------------------------------------------------
  3177.         
  3178.  
  3179.         for them to be in the batch file so they can act as a safeguard.
  3180.         You will also notice a command BRK OFF at the beginning of the batch
  3181.         file example, as well as a BRK ON at the end.  BRK is a Shareware
  3182.         utility distributed by Solid Systems of Newport News, Virginia.  It
  3183.         is used to disable and enable the CTRL BREAK, which can be used to
  3184.         terminate a batch file.  You will need this utility for the
  3185.         protection of your system.  BRK.ARC can be downloaded from Buffalo
  3186.         Creek's BBS.
  3187.           
  3188.              Last but not least, you will notice a command MUV %3 %4.  The
  3189.         file is uploaded to the directory you have configured as your 
  3190.         External Transfer Path and you will remember SPITFIRE must find the
  3191.         file in the appropriate File Area in order for the caller to get credit
  3192.         for the upload and in order for the file to be added to SFFILES.BBS.
  3193.         Well, the MUV %3 %4 command will move the uploaded file to the 
  3194.         appropriate file area.  MUV is a shareware utility by Buffalo Creek 
  3195.         Software that moves a file rather than copying it.  MUV is available 
  3196.         for download from Buffalo Creek's BBS.  There are a number of other 
  3197.         utilities that perform the same function as MUV.  In the event you do 
  3198.         not have MUV, then you can replace the MUV %3 %4 command with the below
  3199.         listed commands:
  3200.         
  3201.         COPY %3 %4
  3202.         ERASE %3
  3203.  
  3204.  
  3205.         17.3 EXTERNAL PROTOCOL SUPPORT
  3206.         ------------------------------
  3207.  
  3208.              Configuring the use of external file transfer protocols will be
  3209.         supported by Buffalo Creek Software for registered users of SPITFIRE.
  3210.         However, should you have problems with the external file transfer 
  3211.         program itself, please read the documentation and then contact the
  3212.         author of the program.
  3213.  
  3214.  
  3215.         18.0  SPITFIRE TECHNICAL REFERENCE INFORMATION
  3216.         ----------------------------------------------
  3217.         
  3218.              There are absolutely no plans whatsoever to release the source
  3219.         code for SPITFIRE.  However, we do feel some information may be of use
  3220.         to our sysops to help them understand how SPITFIRE works, and how it
  3221.         handles certain routines.  If there is something you would like to know
  3222.         which is not covered in this documentation, please ask via Buffalo
  3223.         Creek's BBS (515)-225-8496.  We will make the information available to
  3224.         you, if possible.
  3225.  
  3226.                                                                        Page 58
  3227.         -----------------------------------------------------------------------
  3228.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3229.         -----------------------------------------------------------------------
  3230.         
  3231.  
  3232.         
  3233.              There is certain information that is required for those interested
  3234.         in writing utilities and other third party type programs for SPITFIRE.
  3235.         Listed below are the Turbo Pascal record types that SPITFIRE uses.
  3236.  
  3237.  
  3238.         TYPE
  3239.         UserDefaults  = (HotKey,Reserved,Pause);
  3240.  
  3241.         MessPointer   = Record
  3242.                           Info             : Array[1..7] of String[30];
  3243.                           Subject          : String[40];
  3244.                           Mdate            : String[17];
  3245.                           Where,
  3246.                           NumberofRecords,
  3247.                           Area,OldPosition,
  3248.                           ReplyTo,SeeAlso  : Integer;
  3249.                           Private,Deleted,
  3250.                           Received         : Boolean;
  3251.                         End;
  3252.  
  3253.         MessageBody   = Record
  3254.                           MsgData : String[128];
  3255.                         End;
  3256.  
  3257.         SysRecord     = Record
  3258.                           MSec,FSec     : Integer;
  3259.                           FDesc,MDesc,
  3260.                           FilePath,
  3261.                           UploadPath    : String[60];
  3262.                           MEqual,
  3263.                           FEqual,
  3264.                           PublicMsgArea : Boolean;
  3265.                         End;
  3266.  
  3267.         UsersPtr      = Record
  3268.                           Name : String[30];
  3269.                         End;                  
  3270.  
  3271.                                                                         Page 59
  3272.         -----------------------------------------------------------------------
  3273.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3274.         -----------------------------------------------------------------------
  3275.         
  3276.  
  3277.  
  3278.         Users         = Record
  3279.                           UserName,
  3280.                           CallingFrom     : String[30];
  3281.                           Password,
  3282.                           TimeDate        : String[14];
  3283.                           PhoneNumber     : String[12];
  3284.                           BirthDate       : String[8];
  3285.                           SecurityLevel   : Integer;
  3286.                           Uploads,
  3287.                           Downloads,
  3288.                           TotalUK,
  3289.                           TotalDK         : LongInt;
  3290.                           TimesOn,
  3291.                           TimeLeft,
  3292.                           Last_M_Area,
  3293.                           Last_F_Area,
  3294.                           TransPro        : Integer;
  3295.                           Defaults        : Set Of UserDefaults;
  3296.                           Macro           : Array[1..2] Of String[60];
  3297.                           ScrollBack,
  3298.                           Xpert,
  3299.                           LockedOut,
  3300.                           Deleted         : Boolean;
  3301.                           Linelen,
  3302.                           Pagelen,
  3303.                           OnToday,
  3304.                           Illegal,
  3305.                           DLToday,
  3306.                           ForeGround      : Byte;
  3307.                           LastMsgRead     : Integer;
  3308.                           DLBytes         : LongInt;
  3309.                           NewFCheck       : String[8];
  3310.                           Extra           : String[24];
  3311.                         End;
  3312.  
  3313.                                                                         Page 60
  3314.         -----------------------------------------------------------------------
  3315.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3316.         -----------------------------------------------------------------------
  3317.  
  3318.  
  3319.         SysRec        = Record
  3320.                           LastDate    : String[8];
  3321.                           Callernum   : LongInt;
  3322.                           CallsToday,
  3323.                           MsgToday,
  3324.                           UpToday,
  3325.                           DownToday,
  3326.                           DailyLimit,
  3327.                           DailyLogons,
  3328.                           LogonLimit,
  3329.                           SysopSecurityLevel,
  3330.                           NUS,
  3331.                           NUTL,
  3332.                           DownsPerDay,
  3333.                           D_URatio,
  3334.                           MaxUsers    : Integer;
  3335.                           MNP1,
  3336.                           MNP2,
  3337.                           MNP3,
  3338.                           MNP4,
  3339.                           MNP5,
  3340.                           MNP6        : String[2];
  3341.                           Extran,
  3342.                           PrinterOn,
  3343.                           AnsiAvl,
  3344.                           Private,
  3345.                           SecondPassword,
  3346.                           Page_On,
  3347.                           NO300,
  3348.                           ErrChk      : Boolean;
  3349.                           ModInitStr  : String[56];
  3350.                           SysopName,
  3351.                           SysMsgName  : String[30];
  3352.                           StartDate   : String[18];
  3353.                           ComPort     : Word;
  3354.                           MaxBaud     : LongInt;
  3355.                           TimeComp    : Real;
  3356.                           DOSPassword,
  3357.                           EXEPath     : String[28];
  3358.                           SoftControl : Boolean;
  3359.                           RingNo      : Integer;
  3360.                           DoorsAmt    : Integer;
  3361.                           TimeToday   : LongInt;
  3362.                           DisplayPath,
  3363.                           ExtranPath  : String[28];
  3364.                           Extra       : String[56];
  3365.                           ExtraReal   : Real;
  3366.                         End;
  3367.  
  3368.                                                                         Page 61
  3369.         -----------------------------------------------------------------------
  3370.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3371.         -----------------------------------------------------------------------
  3372.  
  3373.  
  3374.  
  3375.  
  3376.              When a caller goes thru a Door while logged on SPITFIRE, then
  3377.         SPITFIRE writes a simple read-only text file (SFDOORS.DAT) to disk.
  3378.         This text file contains necessary information for the caller to
  3379.         return to SPITFIRE.  Below is a list of the information written to
  3380.         each line of SFDOORS.DAT:
  3381.  
  3382.         User Number (* the record number in SFUSERS.DAT of the caller       *)
  3383.         User Name   (* the full name of the caller                          *)
  3384.         Password    (* the password of the caller                           *)
  3385.         First Name  (* the first name of the caller                         *)
  3386.         Baud Rate   (* baud rate of the caller - i.e. 2400 { 0 if local }   *)
  3387.         Comm port   (* comm port being used by SPITFIRE                     *)
  3388.         Time Left   (* number of minutes the caller has left this log on    *)
  3389.         Time        (* number seconds since midnight when entering the door *) 
  3390.         Path        (* the path in which SPITFIRE.EXE resides {C:\SF\}      *)
  3391.         Ansi_On     (* TRUE if caller is using ANSI else FALSE              *)
  3392.         SecLevel    (* the security level of the caller                     *)
  3393.         Uploads     (* the number of uploads the caller has made            *)
  3394.         Downloads   (* the number of downloads the caller has made          *)
  3395.         This Time   (* total number of minutes allowed for this call        *)
  3396.         Time On     (* number of seconds the caller has been logged on      *)
  3397.         Extra Time  (* number of seconds the caller has gained since log on *)
  3398.  
  3399.  
  3400.         19.0  COMMENT FROM THE AUTHOR
  3401.         -----------------------------
  3402.         
  3403.              This is the third release of SPITFIRE.  Undoubtedly there are
  3404.         features that can be added, such as additional file transfer protocols
  3405.         and so forth.  Your suggestions and comments will certainly be
  3406.         appreciated and considered for future releases.  It is believed that
  3407.         this version of SPITFIRE will more than do the job for you.  However,
  3408.         plans are already in the making for improvements and additions.  These
  3409.         cover three additional file transfer protocols (including ZModem), the
  3410.         ability to read a text file from within an .ARC file and more.
  3411.         Hopefully, SPITFIRE will simply get better and better.
  3412.  
  3413.              There were many people who offered suggestions and discovered
  3414.         problems during the development of SPITFIRE.  It would be nice to list
  3415.         the names of those people but surely I would leave someone out.  I do,
  3416.         however, feel it important to make note that Jacque Shipley kept track
  3417.         of all the changes and improvements in SPITFIRE version 2.5 and
  3418.         spent a tremendous amount of time revising the manual.
  3419.  
  3420.                                                                         Page 62
  3421.         -----------------------------------------------------------------------
  3422.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3423.         -----------------------------------------------------------------------
  3424.  
  3425.         
  3426.  
  3427.              As mentioned earlier, SPITFIRE is written in Borland's Turbo
  3428.         Pascal (v5.0).  This entire program was written by Mike Woltz, however,
  3429.         it would be remiss not to mention that certain code within SPITFIRE
  3430.         was originally written by others.  The async routines were originally
  3431.         written by Edwin T. Floyd and modified by Woltz.  The original SEAlink
  3432.         transfer protocol code (download) was written by Jim Louvau and then
  3433.         nearly totally re-written by Woltz (upload by Woltz).  The original
  3434.         code for viewing an .ARC file was by Woltz and then revised by Jeff
  3435.         Chumbley and then re-revised by Woltz.  I would be remiss if I didn't
  3436.         mention that Jay Dyson, Walt Crede, Jacque Shipley and Doug Vangorp
  3437.         were very instrumental in creating this manual.
  3438.         
  3439.              It has taken over a year to get SPITFIRE to this point (maybe
  3440.         I'm slow).  This opportunity is taken to thank my wife Ann and my
  3441.         children Mason, Jesse & Amanda for tolerating the countless number of
  3442.         hours that were spent writing and testing SPITFIRE.  Lord knows, I
  3443.         could be a better husband and father.
  3444.  
  3445.  
  3446.  
  3447.         20.0  SPITFIRE UTILITIES
  3448.         ------------------------
  3449.  
  3450.              As utilities for SPITFIRE are written and made available, they
  3451.         will be added to this manual.  Inasmuch as SPITFIRE is a very new BBS
  3452.         software at the time that this manual is being written, there are
  3453.         still a number of utilities available.  They are as listed below:
  3454.         
  3455.         NAME                                                          AUTHOR
  3456.         --------------------------------------------------------------------
  3457.         THOUGHTS.ARC..................................Buffalo Creek Software
  3458.         Used to maintain & create THOUGHTS.BBS.....................Shareware
  3459.         
  3460.         SFHELP.ARC....................................Buffalo Creek Software
  3461.         Used to maintain & create SPITFIRE.HLP.................Public Domain
  3462.         
  3463.         MANAGER.ARC...................................Buffalo Creek Software
  3464.         Used to maintain SPITFIRE File Areas.......................Shareware
  3465.         
  3466.         SFLOG.ARC.....................................Buffalo Creek Software
  3467.         Callers Statistical Utility............................Public Domain
  3468.         
  3469.         MKSFMENU.ARC..................................Buffalo Creek Software
  3470.         Creates menu display files for SPITFIRE................Public Domain
  3471.         
  3472.         RECFIND.ARC...............................................Bob Hindal
  3473.         Maintains SPITFIRE users file plus more....................Shareware
  3474.  
  3475.                                                                         Page 63
  3476.         -----------------------------------------------------------------------
  3477.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3478.         -----------------------------------------------------------------------
  3479.  
  3480.         
  3481.  
  3482.         WC2SF.ARC.............................................Jacque Shipley
  3483.         Converts Wildcat BBS users file to SPITFIRE................Shareware
  3484.  
  3485.         TOPTEN.ARC.............................................Jeff Chumbley
  3486.         Creates display files for top ten users................Public Domain
  3487.  
  3488.         B-DAY.ARC..............................................Jeff Chumbley
  3489.         Creates [x].BBS files to wish users a happy birthday...Public Domain
  3490.         
  3491.         OFFHOOK.ARC...................................Buffalo Creek Software
  3492.         Used to take phone off hook for maintenance............Public Domain
  3493.         
  3494.         PCB_SF.ARC............................................Jacque Shipley
  3495.         Converts PC Board users file to SPITFIRE users file........Shareware
  3496.  
  3497.         RBBS_SF.ARC...........................................Jacque Shipley
  3498.         Converts RBBS users file to SPITFIRE users file............Shareware
  3499.  
  3500.         FIDO_SF.ARC...........................................Jacque Shipley
  3501.         Converts Fido users file to SPITFIRE users file............Shareware
  3502.  
  3503.         WC103_SF.ARC..........................................Jacque Shipley
  3504.         Converts Wildcat(v1.03) users file to SPITFIRE users file..Shareware
  3505.  
  3506.         WC112_SF.ARC..........................................Jacque Shipley
  3507.         Converts Wildcat(v1.12) users file to SPITFIRE users file..Shareware
  3508.         
  3509.         THOTS.ARC......................................Combination of People
  3510.         THOUGHTS.BBS...Over 600 "Thoughts"...Nicely done.......Public Domain
  3511.         
  3512.         MKSFFBBS.ARC..................................Buffalo Creek Software
  3513.         Used to create and maintain SFFILES.BBS................Public Domain
  3514.         
  3515.         SFTODAY.ARC...................................Buffalo Creek Software
  3516.         Used to create "Today in History" display files............Shareware 
  3517.  
  3518.         SFMKLIST.ARC..................................Buffalo Creek Software
  3519.         Creates list of all or part of your files for download.....Shareware 
  3520.  
  3521.         GT_SF.ARC..............................................Dave Steinman
  3522.         Converts GT Powercom users file to SPITFIRE users file.....Shareware
  3523.         
  3524.         GEN_SF.ARC.............................................Jacque Shipley
  3525.         Converts Genesis users file to SPITFIRE users file..........Shareware
  3526.         
  3527.         SFDNLDS.ARC............................................Jacque Shipley
  3528.         File listing of BBS download activity.......................Shareware
  3529.  
  3530.                                                                         Page 64
  3531.         -----------------------------------------------------------------------
  3532.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3533.         -----------------------------------------------------------------------
  3534.   
  3535.  
  3536.         WCFIL_SF.ARC...........................................Jacque Shipley
  3537.         Converts Wildcat (v1.12) file listings to SPITFIRE..........Shareware
  3538.  
  3539.         SETCHAT.ARC....................................Buffalo Creek Software
  3540.         Enables setting page on/off automatically in SF.BAT.....Public Domain
  3541.  
  3542.         
  3543.         
  3544.  
  3545.                                                                         Page 65
  3546.         -----------------------------------------------------------------------
  3547.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3548.         -----------------------------------------------------------------------
  3549.  
  3550.         APPENDIX A
  3551.         ---------- 
  3552.            
  3553.            MODEM INITIALIZATION STRINGS
  3554.            ----------------------------
  3555.            
  3556.            The following is a list of modems and their corresponding initial-
  3557.         ization strings which have been tested to work with SPITFIRE Bulletin
  3558.         Board System.
  3559.         
  3560.         
  3561.         MODEM                                      MODEM INITIALIZATION STRING
  3562.         ----------------------------------------------------------------------
  3563.         [1]  US Robotics HST 9600......(9600 Baud)......ATS0=1Q0V0E0M0H0S2=1X1
  3564.         [2]  USR HST 9600..(19200 Baud)..ATS0=1&B1&N0&H3&R2&Y3Q0V0E0M0H0S2=1X1
  3565.         [3]  US Robotics Courier 2400...................ATS0=1Q0V0E0M0H0S2=1X1
  3566.         [4]  Hayes 1200..(External).....................ATS0=1Q0V0E0M0H0S2=1X1
  3567.         [5]  Hayes 2400..(External)..............AT&C1&D2&T5M0H0X1V0E0S2=1S0=0
  3568.         [6]  Everex 24...(Internal 2400).........AT&C1&D2&T5M0H0X1V0E0S2=1S0=0
  3569.              Everex......(Internal 2400)...........ATM0E0V0X1&D3&T5&L1S0=0S2=1
  3570.         [7]  Franklin FM-2400E..........................ATS0=1Q0V0E0M0H0S2=1X1
  3571.         [8]  Avatex 1200 HC.............................ATS0=0Q0V0E0M0H0S2=1X1
  3572.         [9]  Smart One..(Best Data Products of CA)......ATS0=0Q0V0E0M0H0S2=1X1
  3573.         [10] Anchor..(Internal 2400)....................ATS0=3Q0V0E0M0H0S2=1X4
  3574.         [11] US Robotics Sportster...............AT&C1&D2&T5M0H0X1V0E0S2=1S0=0
  3575.         [12] Commstar 2400..(Internal)..................ATS0=3Q0V0E0M0H0S2=1X4
  3576.         [13] Compaq Internal 2400........................AT&F&C1&D2&B1V0S2=1&W
  3577.         [14] Practical Peripheral Internal 2400..AT&C1&D2&T5M0H0X1V0E0S2=1S0=0
  3578.         [15] Hayes 1200..(Internal).....................ATS0=3Q0V0E0M0H0S2=1X4
  3579.         [15] Hayes 2400..(Internal).....................ATS0=3Q0V0E0M0H0S2=1X4
  3580.         [16] Fastalk 2400..(External)...................ATS0=1Q0V0E0M0H0S2=1X1
  3581.         [17] Magitronic MB2450..(Internal)..........AT&C1&D2M0H0X1V0E0S2=1S0=0
  3582.         [18] Capetronics MD 1207...1200 Baud..............ATE0V0Q0M0S2=1S0=2X1
  3583.         [19] Mikon Super Modem...(2400 External)........ATS0=0Q0M0V0E0S2=1X1&W
  3584.  
  3585.                                                                         Page 66
  3586.         -----------------------------------------------------------------------
  3587.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3588.         -----------------------------------------------------------------------
  3589.                                               
  3590.  
  3591.         APPENDIX B
  3592.         ----------
  3593.              
  3594.              REGISTERED SPITFIRE BULLETIN BOARD SYSTEMS
  3595.              ------------------------------------------
  3596.              
  3597.              As copies of SPITFIRE are registered, this manual will be revised
  3598.         to list the public Bulletin Boards using registered copies SPITFIRE.
  3599.         Listed below are the present public Bulletin Boards using registered
  3600.         copies of SPITFIRE...
  3601.  
  3602.         ICUL Cupboard................................515-279-1713...19200 Baud
  3603.         Bear Facts BBS.....(Temporarily down)........515-285-7733...19200 Baud
  3604.         Ast Turbo Byte...............................515-981-0036...19200 Baud
  3605.         The Silicon Lab..............................813-869-3700...19200 Baud
  3606.         The Mother Board.............................515-986-3464....9600 Baud
  3607.         Sirus Cybernetics............................515-280-9107....2400 Baud
  3608.         Walstreet BBS................................515-223-1113....2400 Baud
  3609.         The User Surly Board.........................515-989-4486....2400 Baud
  3610.         The "FOOLISH PLEASURE" BBS...................312-758-1136....2400 Baud
  3611.         Roam This Fertile Land BBS...................515-288-8755....2400 Baud
  3612.         ArcLink BBS..................................907-248-9625....2400 Baud
  3613.         PDR BBS......................................213-821-2221....2400 Baud
  3614.         Windy City BBS...............................312-735-9553....2400 Baud
  3615.         Gateway AMIGA Club BBS.......................314-225-1409....2400 Baud
  3616.         Park Place BBS...............................813-545-0401....2400 Baud
  3617.         ASAHI BBS....................................919-444-1473....2400 Baud
  3618.         Central Maryland BBS.........................301-781-7127....2400 Baud
  3619.         The Henry George KnowledgeBase BBS...........818-353-2242....2400 Baud
  3620.         The MainFrame BBS............................312-364-0425....2400 Baud
  3621.         Hacker's BBS.................................302-322-8215....2400 Baud
  3622.         Northern Illinois BBS........................815-756-8593....2400 Baud
  3623.         Jim's Little Bulletin Board..................601-286-5749....2400 Baud
  3624.         The Green Dragon Inn.........................515-265-7300....1200 Baud
  3625.  
  3626.                                                                         Page 67
  3627.         -----------------------------------------------------------------------
  3628.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3629.         -----------------------------------------------------------------------
  3630.  
  3631.  
  3632.        APPENDIX C
  3633.        ----------
  3634.        
  3635.           SPITFIRE QUESTIONS AND ANSWERS
  3636.           ------------------------------
  3637.  
  3638.  
  3639.         QUESTION: Why is the "Do You Want ANSI Graphics? [y/N]" displayed 
  3640.                   each time a user logs on the BBS?
  3641.                                         
  3642.         ANSWER:   Some BBS software stores in the users file whether or not
  3643.                   a caller uses ANSI, and if so, then each time the user logs
  3644.                   on, ANSI graphics are automatically displayed.  When creating
  3645.                   SPITFIRE, it was decided to provide the user with the
  3646.                   opportunity to select the display preferred at each log on.
  3647.                   There are two basic reasons for including this prompt to
  3648.                   each user upon log on.  First, some users may call the BBS
  3649.                   from different locations.  For instance, many users call the
  3650.                   BBS from work as well as from home and while they may have a
  3651.                   color monitor at home, they may not at work.  In such a case,
  3652.                   they would not want to use color graphics each time they log
  3653.                   on.  Also, observation has proven that a user may sometimes
  3654.                   choose Ansi graphics and other times not.  This may be due to
  3655.                   the amount of time a user has to spend on the board since
  3656.                   ANSI graphics display slower than those created in ASCII. 
  3657.                   For whatever their reasons may be, SPITFIRE demonstrates
  3658.                   increased flexibility by allowing the user to make that
  3659.                   choice.
  3660.                                      
  3661.                                         
  3662.         QUESTION: With SPITFIRE at the "Ready For Caller..." prompt, the phone
  3663.                   rings and an incoming call is announced on the screen.
  3664.                   However, before the caller is connected to the BBS system,
  3665.                   the program returns to the "Ready For Caller..." prompt.
  3666.                                         
  3667.         ANSWER:   SPITFIRE relies on numeric result codes to determine the
  3668.                   baud rate of the incoming call.  If SPITFIRE announces an
  3669.                   "Incoming call.." and then immediately goes back to the
  3670.                   "Ready for caller..." prompt, this means that your modem
  3671.                   sent something to SPITFIRE but not a correct result code.
  3672.                   This problem would indicate that the modem initialization
  3673.                   string is not correct.  If the initialization string
  3674.                   contains S0=1 try changing this to S0=0 or vice versa.  If
  3675.                   this does not remedy the situation, you should try using
  3676.                   another initialization string. This manual contains a list
  3677.                   of several initialization strings which have been tested
  3678.                   and are known to work with the various modems listed.
  3679.                   Also, please note, that the initialization string must
  3680.  
  3681.                                                                         Page 68
  3682.         -----------------------------------------------------------------------
  3683.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3684.         -----------------------------------------------------------------------
  3685.                                     
  3686.  
  3687.                   contain the numeric character 0 (zero) and NOT the
  3688.                   alphabetical character O.
  3689.                                      
  3690.                   Once you have discovered an initialization string that works
  3691.                   with your modem, please report said string and the complete
  3692.                   name and information pertaining to your modem so this
  3693.                   information can be added to this manual.
  3694.  
  3695.  
  3696.         QUESTION: When attempting to jump to DOS with the Alt+J command, the
  3697.                   screen blinks but nothing happens.  What can be done to
  3698.                   rectify this?
  3699.                                      
  3700.         ANSWER:   Depending on the individual's system, occasionally the Alt+J 
  3701.                   command which allows the Sysop to drop to DOS appears to be
  3702.                   inoperative.  The situation can easily be corrected by
  3703.                   placing COMMAND.COM file in the root directory of the drive
  3704.                   on which SPITFIRE.EXE resides.
  3705.                                      
  3706.                                      
  3707.         QUESTION: How is it possible to set up a SPITFIRE File Area without
  3708.                   also creating a SPITFIRE Message Area?
  3709.                                      
  3710.         ANSWER:   A file area can be created without having a sister message
  3711.                   area simply by changing the security level of the sister
  3712.                   message area to a security level higher than any user's
  3713.                   access capability.  For instance, most Sysops use the
  3714.                   security level of 999.  Setting the unused message area
  3715.                   security level at 1000 will prevent it from being displayed.
  3716.                   This same procedure can be used to prevent an unused file
  3717.                   area from being displayed when a sister message area is
  3718.                   created.
  3719.                                          
  3720.  
  3721.         QUESTION: When a user uploads a file to "Sysop Only", how is the Sysop
  3722.                   made aware of the uploaded file?
  3723.                                               
  3724.         ANSWER:   SPITFIRE incorporates two techniques by which the Sysop is
  3725.                   notified that a file has been uploaded privately to them.
  3726.                   A message is written both in the CALLERS.LOG and also
  3727.                   the HEYSYSOP.LOG file that informs the Sysop that a file
  3728.                   has been uploaded for "Sysop Only".  The CALLERS.LOG and the
  3729.                   HEYSYSOP.LOG file can be viewed from the Sysop Menu and
  3730.                   should be checked regularly to keep the Sysop aware of the
  3731.                   various BBS activities.
  3732.  
  3733.                                                                         Page 69
  3734.         -----------------------------------------------------------------------
  3735.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3736.         -----------------------------------------------------------------------
  3737.                                     
  3738.  
  3739.                                               
  3740.  
  3741.         QUESTION: When responding to a message, SPITFIRE requests me
  3742.                   to specify the Message Area I wish the reply to be
  3743.                   saved to.  Why doesn't SPITFIRE automatically save
  3744.                   it to the same Message Area as the original message 
  3745.                   I am replying to?
  3746.              
  3747.         ANSWER:   SPITFIRE allows the Sysop of each system to specify
  3748.                   whether each Message Area will allow only Public or 
  3749.                   Public and Private messages.  The reason SPITFIRE
  3750.                   does not automatically save a message reply to the
  3751.                   same Message Area as the original message, is to
  3752.                   provide the user the option of responding privately 
  3753.                   to a message which was saved in an all Public 
  3754.                   Message Area.  For instance, if you were responding
  3755.                   to an all Public message and the reply was saved
  3756.                   to the same Message Area as the original message by
  3757.                   default, it would be impossible to enter a private
  3758.                   reply to the original message.
  3759.              
  3760.  
  3761.         QUESTION: After successfully running SPITFIRE for sometime, all of
  3762.                   a sudden upon booting up, a message is displayed that the
  3763.                   SFUSERS.DAT file was not found.  Why did this happen?
  3764.                                               
  3765.         ANSWER:   When SPITFIRE is installed a file named SFSYSDAT.SYS is
  3766.                   created.  This file contains information as to what drive
  3767.                   and directory the SPITFIRE system and work files exist.
  3768.                   If after using the program, the Sysop changes the location
  3769.                   of SPITFIRE (for example, SPITFIRE was orginally booted up
  3770.                   on a floppy and then moved to Drive C), SPITFIRE will
  3771.                   continue to look for the files in the originally specified
  3772.                   location.  The easiest way to rectify this situation is to
  3773.                   erase the existing SFSYSDAT.SYS file and allow a new one to
  3774.                   be created.  SPITFIRE will automatically assign the default
  3775.                   path to the one in which SPITFIRE.EXE resides.
  3776.                                               
  3777.  
  3778.         QUESTION: After adding new files to the various file areas for the
  3779.                   users to download, I noticed that when a caller logs
  3780.                   onto the BBS and does a check for new files, these files
  3781.                   are not displayed.  What is the problem?
  3782.                                               
  3783.         ANSWER:   There are basically two reasons this could happen.  The
  3784.                   first being, it is possible the files were copied into the
  3785.                   download directories but not added to the appropriate
  3786.                   SFFILES.BBS file.  Another possible explanation would be
  3787.  
  3788.                                                                         Page 70
  3789.         -----------------------------------------------------------------------
  3790.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3791.         -----------------------------------------------------------------------
  3792.                                     
  3793.  
  3794.                   that the file name, file size, file date and file
  3795.                   description has not been located in the exact specified
  3796.                   place in the SFFILES.BBS.  Refer to Section 3.4 of this
  3797.                   manual for further information regarding this subject.
  3798.  
  3799.  
  3800.         QUESTION: Why are users unable to view the contents of an .ARC file
  3801.                   after selecting <W>hat's In An Arc File from the File Menu.
  3802.  
  3803.         ANSWER:   This feature will only works with MS/PC DOS archive files.
  3804.                   If could be that the .ARC file in question was archived by
  3805.                   a system other than MS/PC DOS and then uploaded to your
  3806.                   BBS.
  3807.  
  3808.  
  3809.         QUESTION: The callers log reveals "message sent and erased" for a
  3810.                   user who logged onto the BBS.  What does this mean?
  3811.                                               
  3812.         ANSWER:   This would depict a special notice ( [x].BBS; refer to
  3813.                   Section 3.4 of the documentation for further explanation
  3814.                   regarding this subject) was left for a specific user.  Once
  3815.                   the user receives this message it is automatically erased.
  3816.                   The CALLERS.LOG displays the above mentioned message to
  3817.                   inform the Sysop the message was sent and then erased.
  3818.                                               
  3819.  
  3820.         QUESTION: The HEYSYSOP.LOG reveals a message that a specific archived
  3821.                   file fails the CRC check.  What does this mean?
  3822.                                               
  3823.         ANSWER:   Anytime the Sysop is notified that an archived MS/PC DOS file
  3824.                   fails the CRC check, this means that the specified file is
  3825.                   corrupt and should be erased from your system.
  3826.  
  3827.                        Thank you very much for selecting SPITFIRE.
  3828.  
  3829.                   
  3830.                                                                         Page 71
  3831.         -----------------------------------------------------------------------
  3832.         -+  SPITFIRE BULLETIN BOARD SYSTEM - Version 2.5 - October 22, 1988  +-
  3833.         -----------------------------------------------------------------------
  3834.         NOTES:
  3835.  
  3836.